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To obtain editions of this publication that pertain to earlier releases of 
VM/SP, you must order using the pseudo-number assigned to the respective 
edition. For: 

Release 3, order SQ24-5220 

Release 2, order ST24-5220 

Release 1, order ST24-5220. 



Summary of Changes 
for SC24-5220-2 
VM/SP Release 4 

The XEDIT enhancements described in this document provide new or 
improved support in the following areas: 

o Structured Input 

SI Prefix Macro (to continuously add new lines of indented text) 
o Usability 

(all messages issued by the editor are in mixed case). 
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Summary of Changes 
for SC24-5220-1 
VM/SP Release 3 

The XEDIT enhancements described in this document provide new or 
improved support in the following areas: 



— i (writing prefix macros, < (shift left) and > (shift right) prefix macros, 

and LPREFIX) 

• Selective Line Editing (ALL) 

• Screen Control 

i (SET MSGLINE, SET CMDLINE, SET SCREEN, SET COLOR) 

J ' 

Summary of Amendments 111 



o Extended Data Manipulation 

(MERGE, the logical AND operator for targets, SET FULLREAD) 

o Miscellaneous Enhancements 

(SET POINT, command line arrow extension, the alteration count on 
the screen (Alt = n), new initial PF10, PF11, and PF12 settings). 
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Preface 



~T This book was written primarily for the individual who has limited data 

processing experience. It is designed to give you a working knowledge of 
~i the System Product editor (also referred to as XEDIT). 

~~] The System Product editor provides a wide range of functions for text 

processing and program development. Both a full-screen and a line-mode 
~i editor, it can be used on display and typewriter terminals. 

"I Some highlights of the editor discussed in this book are: 

"1 o Extended string search facilities for improved text processing 

"~1 o Automatic "wrapping" of lines that are longer than a screen line 

""] o The ability to enter selected subcommands directly on a displayed line 

~1 * o The ability to tailor the full-screen layout 

""] o The ability to divide the screen in order to display multiple views of the 

same or of different files 

3 

o A variety of macros for improved text processing, such as macros to join 
~] and split lines 

"^J o A HELP facility that provides an online full-screen display of any 

XEDIT subcommand or macro (or any command in the CMS HELP 
~J facility) during an editing session. 

^] I The System Product Editor can manipulate Double-Byte Character Set 

| strings (KANJI, for example). Special considerations for editing files that 

^J I contain double-byte characters are described in the VMjSP System Product 

| Editor Command and Macro Reference. 

3 
I] 



How To Use This Book 



— ■] This book relies on "before-and-after" examples that illustrate the text. 

You can also try out these examples for practice. 



Preface V 



The first three chapters are intended for data processing novices: 




Chapter 1: An XEDIT Subset: Full-Screen Text Processing is written for the 
inexperienced user who has a display terminal used in full-screen mode. It 
defines a subset of XEDIT subcommands that perform commonly-used editing 
functions. 




Chapter 2: A Practice Exercise is designed to give you practice in using the 
subcommands presented in Chapter 1. It is an interactive text, that is, it 
walks you through an editing session, step by step. 




Chapter 3: An XEDIT Subset: Text Processing on a Typewriter Terminal is 
similar to Chapter 1, but is written for a new user who has a typewriter 
terminal. 




The last four chapters are intended both for new users who have mastered 
the fundamentals and for data processing professionals. These chapters 
introduce more sophisticated editing functions: 

Chapter 4: Using Targets explains how to use the editor's extended string 
search facilities. Targets are used to move the line pointer and to define the 
range of many XEDIT subcommands. 



—3 



Chapter 5: Editing Multiple Files explains how to edit multiple files and how 
to divide the screen into multiple logical screens for multiple views of the 
same or of different files. 




Chapter 6: Tailoring the Screen explains how you can alter the screen layout 
to suit yourself. 




Chapter 7: The Macro Language explains how to write XEDIT macros and 
also explains how to write a profile macro. 



The Appendix is a summary of all XEDIT subcommands and their functions. 
These subcommands are described in detail in the publication VM/SP 
System Product Editor Command and Macro Reference. 
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Editing a File 



This chapter is written primarily for the person who has limited data 
processing experience; however, some Virtual Machine/System Product 
(VM/SP) CMS experience is assumed. For example, you must know how to 
log on to VM/SP and enter the CMS environment. You should also be 
familiar with the concept of a CMS file. 

When you finish this chapter, you should have a working knowledge of the 
editor. The subcommands presented here comprise a subset of XEDIT 
subcommands, with which you can create a file, enter data, manipulate the 
screen, make changes to the file, and transfer data between files. 

The editor has many additional capabilities, which are described in the rest 
of this book and in the publication VM/SP System Product Editor 
Command and Macro Reference. 

This subset has been selected for text processing on a display terminal used 
in full-screen mode. (If you have a typewriter terminal, refer to Chapter 3.) 



To edit a file means to make changes, additions, or deletions to a CMS file 
that is on a disk, and to make these changes interactively: you instruct the 
editor to make a change, the editor makes it, and then you request another 
change. 

You can edit a file that does not exist; when you do so, you are creating a 
file. 
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XEDIT Command 



After you log on to VM/SP and enter the CMS environment, you are ready 
to enter the edit environment and begin creating a file. The editor is 
invoked with the CMS command XEDIT, whose format is as follows: 

XEDIT filename filetype 

In Figure 1, the editor was invoked with the following command: 

Chapter 1. An XEDIT Subset: Full-Screen Text Processing 1 



u <= i!r > 



Screen Layout 



XEDIT INVENTOR SCRIPT 



Before we see how to enter data in the file, let's look at the screen layout 
illustrated in Figure l. 1 



INVENTOR SCRIPT Al V 132 Trunc=132 Size=<X Line=0 Col=l Alt=0 
Creating new file 




2) MESSAGE LINE 




1) FILE IDENTIFICATION LINE 




FILE AREA 



* * */Top of File * * * 

. .1 + 2 + . 

*/* End of File * * * 



7J CURRENT LINE 
3 + 4 + 



.5 + , 

SCALE 



5) PREFIX AREA 




====> INPUT ■*■ 



-@ COMMAND LINE 



STATUS AREA 




XEDIT 1 File 



Figure 1. The Screen Layout 



(T^ File Identification Line 

The first line on the screen identifies the file being edited. The 
following information is displayed: 



1 If your screen layout differs from Figure 1, or some of the commands or PF 
keys work differently than this guide says they will, you may have a 
PROFILE XEDIT macro tailoring your editing session. To keep the PROFILE 
XEDIT macro from executing, add the NOPROFILE option: 

XEDIT filename filetype (NOPROFILE 

See "A Profile Macro for Editing" on page 150 for more information on the 
PROFILE XEDIT macro. 

If these problems continue while using NOPROFILE, be sure this guide was 
written for your system's release level of VM/SP. See the front cover of this 
guide for its release level and use QUERY CMSLEVEL (see "QUERY" in the 
VM/SP CMS Command and Macro Reference) to find the release level of your 
system's VM/SP. If they are different, use the guide that matches your 
system's VM/SP release level. 
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a. filename, filetype, filemode 
~] If you do not specify a filemode, the editor assigns a filemode of 

"Al," which means that the file is to become part of a file 
"1 collection called your "A-disk". 

~2 b. record format and record length 

The record format and record length (V 132) shown in the 
""J example mean that in this file, the length of a line can vary and 

the file will hold lines up to 132 characters long. Therefore, a 
2J file line can be longer than a screen line. 

_] c. truncation column (Trunc = ) 

Notice that the truncation column is the same as the record 
3 length (132). Since a file line can be only 132 characters long, 

any data that is entered beyond 132 characters (in total) may be 
^] truncated. 

_] d. current number of lines in the file (Size = ) 

(Since we have not yet entered data in the file, the number of 
_] lines is zero.) 



e. file line number of the current line (Line = ) 
(See number 7, below.) 



_J 

:j 

f. position of the column pointer (Col = ) 
_J (See number 8, below.) 

_] g. alteration count (Alt = ) The alteration count is the number of 

alterations that have been made to the file since the last 
_] AUTOSAVE (which is explained later in this chapter). 

_J (2) Message Line 

The editor communicates with you by displaying messages on the 
I second and third lines of the screen. These messages tell you if you 

have made an error, or they provide information. In Figure 1, the 
J message line shows that you are creating a new file. 

I (3!) Command Line 

The large arrow (= = = = >) at the bottom of the screen points to 
I the command input area. One of the ways you communicate with 

the editor is by entering XEDIT subcommands on this line. 
_J Subcommands can be typed in either uppercase or lowercase, or a 

combination of both, and many can be abbreviated. For example, 
J "INPUT," "Input," and "i" are all valid ways to type the INPUT 

subcommand. 

After typing a subcommand on the command line, you must press 
— I the ENTER key to execute the subcommand. Figure 1 shows the 

subcommand "INPUT" typed in the command line. (To move the 
— 1 cursor from any place on the screen to the command line, just press 

_. the ENTER key or PF12). 



I] 



"1 
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© Status Area 

The lower right corner displays the current status of your editing 
session, for example, edit mode or input mode, and the number of 
files you are editing. The status area in Figure 2 shows that one 
file is being edited. 

Qx) Prefix Area 

The prefix area is the five left-most columns on the screen and 
displays five equal signs (= = = = =). Each line in the file has a 
prefix area associated with it. 

You can perform various editing tasks, like deleting a line, by 
entering short commands, called "prefix subcommands," in the 
prefix area of any line. 

© File Area 

The rest of the screen is available to display the file. 

You can make changes to the file by moving the cursor under any 
line and typing over the characters, or by using special keys to 
insert or delete characters. You can make as many changes as you 
want on the displayed lines before pressing the ENTER key. When 
you press the ENTER key, the corresponding changes are made to 
the copy of the file that is kept in virtual storage. At the end of the 
editing session, a FILE subcommand will permanently record those 
changes on the copy of the file that resides on disk. 

Since a file may be too long to fit on one screen, various 
subcommands are used to scroll the screen so that you can move 
forward and backward in a file. 

© The Current Line 

The current line is the file line in the middle of the screen (above 
the scale). It appears brighter than the other file lines; we say it is 
"highlighted." 

In Figure 2, the current line is the "Top of File" line; at this point, 
the file contains no data. 

The current line is an important concept, because most 
subcommands perform their functions starting with the current line. 
Naturally, the line that is current changes during an editing session 
as you scroll the screen, move up and down, and so forth. When the 
current line changes, we say that the line pointer (not visible on the 
screen) has moved. Many XEDIT subcommands perform their 
functions starting with the current line, and move the line pointer 
when they are finished. 

© Scale 

The scale appears under the current line to assist you in editing. 
It's like the margin scale on a typewriter. 
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Entering Data 



INPUT Subcommand 



The vertical bar (|) that appears in column one on the scale is the 
column pointer. Various subcommands perform their functions 
within a line starting at the column pointer, which you can move to 
different positions on the scale by using XEDIT subcommands that 
will be discussed later. The column under which the column pointer 
is positioned is called the current column. 



After you enter the XEDIT command, you are in edit mode. 
edit mode to enter XEDIT subcommands. 



You must be in 



You can enter data into the file using input mode or power typing mode, 
which are discussed in the following sections. 



To enter input mode, type the following subcommand in the command line 
and press the ENTER key: 

====> INPUT 

You can then type in your data in the input zone, which is the bottom half 
of the screen (between the scale and the command line). 

Figure 2 through Figure 4 is the same file, INVENTOR SCRIPT, that is 
shown in Figure 1. However, the INPUT subcommand has been entered 
and the lines of data have been typed on the screen. Notice how the screen 
changes in input mode: the prefix areas ( = = = = = ) disappear; the message 
line and status area tell you that you are in input mode; the command line 
contains the phrase "Input Zone," which marks the end of the input zone 
and reminds you that you cannot enter subcommands in input mode. 

In Figure 2, the entire input zone has been filled. To stay in input mode 
and type more data, press the ENTER key once. The lines that you typed 
move to the top half of the screen, with the last line you typed becoming 
the new current line. The input zone is available to type more data, as 
shown in Figure 3. 
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INVENTOR SCRIPT Al V 132 Trunc=132 Size=9 Line=0 Col=l Alt=0 
Input mode: 



* * * Top of File * * * 

I... + ....1.. .. + ... .2. ... + ....3..-. . + ....4. ... + .. ..5. ... + ... .6. ... + .. ..7. ... + .... 

THE ELECTRONIC COMPUTER (1946) 

THE WORLD'S FIRST ELECTRONIC COMPUTER WAS CALLED ENIAC, ELECTRONIC 

NUMERICAL INTEGRATOR AND COMPUTER. 

IT WAS BUILT BY A GROUP OF RESEARCHERS LED BY AMERICAN PHYSICIST 

JOHN MAUCHLY AT THE UNIVERSITY OF PENNSYLVANIA. 

UNLIKE EARLIER COMPUTERS, THIS ONE RAN ON RADIO TUBES - 18,000 OF THEM 

IN TOTAL. 

IT FILLED A ROOM 30 FEET BY 50 FEET AND COST $400,000. 

====> * * * input Zone * * * 

Input-mode 1 File 

Figure 2. Input Mode — Typing the Data 

If you have no more data to type, pressing the ENTER key again takes you 
out of input mode and back into edit mode. 

Figure 4 shows how the data looks in the file, after the ENTER key has 
been pressed twice. The display is restored to the edit mode screen layout 
described in Figure 1, and the file contains the data. 

During an editing session, you can enter input mode at any time to insert 
new lines of data in the file. As you have seen, after the INPUT 
subcommand is entered, the editor makes room for you to type new lines of 
data after the current line. In this example, since the file was new and the 
INPUT subcommand was the first subcommand entered, the Top of File line 
was the current line. Later, you will see how to make any line current, so 
that you can use input mode to insert lines between any two existing lines 
in the file. 
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INVENTOR SCRIPT 



Al V 132 Trunc=132 Size=18 Line=9 Col=l Alt=9' 



* * * Top of File * * * 

THE ELECTRONIC COMPUTER (1946) 

THE WORLD'S FIRST ELECTRONIC COMPUTER WAS CALLED ENIAC, ELECTRONIC 

NUMERICAL INTEGRATOR AND COMPUTER. 

IT WAS BUILT BY A GROUP OF RESEARCHERS LED BY AMERICAN PHYSICIST 

JOHN MAUCHLY AT THE UNIVERSITY OF PENNSYLVANIA. 

UNLIKE EARLIER COMPUTERS, THIS ONE RAN ON RADIO TUBES - 18,000 OF THEM 

IN TOTAL. 

IT FILLED A ROOM 30 FEET BY 50 FEET AND COST $400,000. 

| ...+... .1. . ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. . .6. ...+.. . .7. 

USING TEN-DIGIT NUMBERS, IT COULD DO 5,000 ADDITIONS A SECOND. 



====> * * * Input Zone * * * 

Input-mode 1 File 

Figure 3. Input Mode — Continue Typing 



INVENTOR SCRIPT Al V 132 Trunc=132 Size=10 Line=10 Col=l Alt=10 
XEDIT: 

===== the ELECTRONIC COMPUTER (1946) 
===== .sp 

===== the WORLD'S FIRST ELECTRONIC COMPUTER WAS CALLED ENIAC, ELECTRONIC 
===== NUMERICAL INTEGRATOR AND COMPUTER. 

===== IT WAS BUILT BY A GROUP OF RESEARCHERS LED BY AMERICAN PHYSICIST 
===== JOHN MAUCHLY AT THE UNIVERSITY OF PENNSYLVANIA. 

===== UNLIKE EARLIER COMPUTERS, THIS ONE RAN ON RADIO TUBES - 18,000 OF THEM 
===== IN TOTAL. 

===== it FILLED A ROOM 30 FEET BY 50 FEET AND COST $400,000. 
===== USING TEN-DIGIT NUMBERS, IT COULD DO 5,000 ADDITIONS A SECOND. 

| ...+.... 1. . ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. . .7. 
===== * * * En d of File * * * 






Figure 4. Input Mode — Data Entered in the File 



XEDIT 1 File 
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POWERINP Subcommand 

The easiest way to enter a large amount of text, like one long paragraph, is 

by using "power typing." To use power typing, enter the following '■ 

subcommand: 

====> POWER 

[ 

The advantage of using power typing is that you can enter data as if the 

screen were one long line. You do not have to be concerned with line 

length or word length — you can start typing a word on one line of the 

screen and finish it on the next. In fact, if you're a skilled typist, you don't [ 

even have to look at the screen. When you reach the end of a line, the 

editor automatically "wraps around" to the beginning of the next line. You ( 

can type continuously until the screen is filled. 

If you fill up a screen and want to continue typing in power typing mode, 

press the ENTER key once. The last line you typed is displayed at the top [ 

of the screen; the rest of the screen is blank and you can continue typing. 

When you are finished typing, press the ENTER key twice to exit from 

power typing and reenter edit mode. The editor automatically divides the [_ 

data into appropriate screen lines and reconstructs any split words. 

During an editing session, you can use power typing at any time by 
entering the POWERINP subcommand. The data entered using power I 

typing is inserted after the current line, as it is when you use the INPUT 
subcommand. I 

Causing A Break in the Data I 

If you want to cause a break in the data that you type in power typing I 

mode, that is, you want data to start on a new line (for example, a new 

paragraph or SCRIPT/VS control words, which must start in column one), 1 

you can type a line end character before the data that you want to start on 

a new line. The default line end character is a pound sign (#). 

For example, if the following data is typed in power typing mode: 

. sp#A pound sign causes the data to start on a new line.#.sp r ~ 

The data will be entered in the file as: f 

===== .sp r 

===== A pound sign causes the data to start on a new line. 
===== .sp 
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If you want to insert characters or spaces in a line while you are in power 
-I typing mode, you can use the insert mode key. When characters are 

inserted, the entire stream of data shifts to the right; it's like inserting a 
box car in a train. Remember to press the RESET key when you are 
finished inserting characters. 



Inserting Characters 



An Example of Power Typing 



Figure 5 illustrates the same file, INVENTOR SCRIPT, but the data was 
typed in power typing mode, after the POWERINP subcommand was 
entered. The screen changes in several ways in power typing mode: the 
prefix and status areas disappear; the line that was current when the 
POWERINP subcommand was entered moves to the top of the screen, and 
the rest of the screen is available for typing data. Notice how a word can 
start at the end of a line and finish on the next. The entire screen can be 
filled with data, but it doesn't have to be. 

Notice the pound signs (#) in the eighth line (from the top of the screen). A 
pound sign causes the data that follows it to begin on a new line when it is 
entered into the file. The pound sign itself is not entered in the file. 

Figure 6 shows how the screen looks after the ENTER key was pressed 
twice. The screen layout is restored, and the words and lines are 
reconstructed. After you press the ENTER key twice, the lines you typed 
are entered and the pound sign line separator is interpreted. Any data that 
was preceded by a pound sign begins on a new line. The last line entered 
becomes the current line. In order to display the entire file on your screen, 
change the current line to a point above the End of File line by placing a 
slash (/) in the prefix area and pressing the ENTER key. Figure 6 was 
produced by placing a slash in the prefix area of the line beginning, 
"DOING EXPERIMENTS WITH . . ." and pressing the ENTER key. 
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INVENTOR SCRIPT Al ***Power Typing*** Alt=0 
* * * Top of File * * * 

THE WORLD'S FIRST ELECTRONIC COMPUTER WAS CALLED ENIAC , ELECTRONIC NUMERICAL INT 
EGRATOR AND COMPUTER. IT WAS BUILT BY A GROUP OF RESEARCHERS LED BY AMERICAN PH 
YSICIST JOHN MAUCHLY AT THE UNIVERSITY OF PENNSYLVANIA. UNLIKE EARLIER COMPUTER 
S, IT RAN ON RADIO TUBES - 18,000 OF THEM IN TOTAL. IT FILLED A ROOM 30 FEET BY 
50 FEET AND COST $400,000. USING TEN-DIGIT NUMBERS, IT COULD DO 5,000 ADDITION 
S A SECOND. #.sp#A GERMAN PHYSICIST, ROENTGEN, DISCOVERED THE XRAY BY ACCIDENT. 
HE WAS DOING EXPERIMENTS WITH A CROOKES TUBE, WHICH PRODUCED STREAMS OF ELECTRON 
S CALLED CATHODE RAYS. ONE DAY HE LEFT AN ACTIVATED CROOKES TUBE ON A BOOK BEFO 
RE LEAVING THE LABORATORY. HE DID NOT REALIZE THAT A KEY AND SOME PHOTOGRAPHIC 
FILM WERE SANDWICHED IN THE BOOK. LATER, WHEN HE DEVELOPED THE FILM, HE SAW THE 
IMAGE OF THE KEY. THUS WAS THE FIRST XRAY ACCIDENTALLY TAKEN. 



Figure 5. Power Typing 



INVENTOR SCRIPT 



Al V 132 Trunc=132 Size=14 Line=9 Col=l Alt=15 



== THE WORLD'S FIRST ELECTRONIC COMPUTER WAS CALLED ENIAC, ELECTRONIC 

== NUMERICAL INTEGRATOR AND COMPUTER. IT WAS BUILT BY AMERICAN PHYSICIST 

== JOHN MAUCHLY AT THE UNIVERSITY OF PENNSYLVANIA. UNLIKE EARLIER 

== COMPUTERS, IT RAN ON RADIO TUBES - 18,000 OF THEM IN TOTAL. IT FILLED A 

== ROOM 30 FEET BY 50 FEET AND COST $400,000. USING TEN-DIGIT NUMBERS, IT 

: = COULD DO 5,000 ADDITIONS A SECOND. 

: = .sp 

== A GERMAN PHYSICIST, ROENTGEN, DISCOVERED THE XRAY BY ACCIDENT. HE WAS 

== DOING EXPERIMENTS WITH A CROOKES TUBE, WHICH PRODUCED STREAMS OF 

| . . . + 1 + 2 + 3 + 4 + 5 + 6 + 7... 

== ELECTRONS CALLED CATHODE RAYS. ONE DAY HE LEFT AN ACTIVATED CROOKES 
== TUBE ON A BOOK BEFORE LEAVING THE LABORATORY. HE DID NOT REALIZE THAT 
== A KEY AND SOME PHOTOGRAPHIC FILM WERE SANDWICHED IN THE BOOK. LATER, 
== WHEN HE DEVELOPED THE FILM, HE SAW THE IMAGE OF THE KEY. THUS WAS THE 
== FIRST XRAY ACCIDENTALLY TAKEN. 
: = * * * En d of File * * * 

= > 

X E D I T 1 File 



Figure 6. Power Typing — Data Entered in the File 
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j Using Program Function (PF) Keys 

_J Each PF key is set to an XEDIT subcommand, which is executed when the 

key is pressed. Using the PF key saves you the time it takes to type that 
J subcommand on the command line and press the ENTER key. 

_J You can use the following subcommand to display the PF key settings: 

^] ====> QUERY PF 

~1 The following subcommands are initially assigned to the PF keys: 

2] PF1 BEFORE HELP MENU 

PF2 BEFORE SOS LINEADD 

^\ PF3 BEFORE QUIT 

PF4 BEFORE TABKEY 

'J PF5 BEFORE SCHANGE 6 

PF6 ONLY ? 

-] PF7 BEFORE BACKWARD 

PF8 BEFORE FORWARD 

~] PF9 ONLY = 

PF10 BEFORE RGTLEFT 

2] PF11 BEFORE SPLTJOIN 

PF12 BEFORE CURSOR HOME 

I] - 

These are the subcommands that the editor assigns to the PF keys. For 

^] information on the "BEFORE" and "ONLY" operands shown above, see the 

SET PF subcommand in the VM/SP System Product Editor Command and 

_] Macro Reference. 

_] If you would rather have a different subcommand assigned to one (or more) 

of the PF keys, you can use the SET PF subcommand, whose format is as 
_] follows: 



====> SET PFn subcommand 



~ 1 where "n" is a PF key number, and "subcommand" is any XEDIT 

subcommand. 

3 
3 
3 
3 
3 
3 ■ 

( 

3 K 

3 



For example: 

====> SET PF1 INPUT 

assigns the INPUT subcommand to the PF1 key. Pressing the PF1 key 
would immediately place you in input mode. 

When you assign a subcommand to a PF key, the setting remains in effect 
only for the current editing session. In the next editing session, the initial 
settings shown above are in effect. 

The following sections show how to use some of the PF keys (initial 
settings). Others will be discussed where appropriate. 
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Splitting and Joining Lines 



Splitting a Line (PF11) 



Joining Two Lines (PF11) 



The PF11 key enables you to split a line or join two lines, at the cursor 
position. If the cursor is positioned before (or at) the last character in a line, 
the line is split. If the cursor is positioned after the data, the next line is 
joined to it. 



To split a line in two, simply move the cursor under the character where 

you want the line to be split, and press the PF11 key. r- 

In the following line, note the position of the cursor, under the "F" in 
"FOOD". 

===== GILA MONSTERS HOLD RESERVE FOOD SUPPLIES IN THEIR TAILS. T 

Pressing the PF11 key produces the following lines: i 

===== GILA MONSTERS HOLD RESERVE _ [~ 

===== F 00D SUPPLIES IN THEIR TAILS. 

The PF11 key is particularly useful if you want to add information to a line. 

In the following line, the cursor is placed under the "I" in "IN": r 

===== BIRD SPECIES HAVE DWINDLED IN THE LAST 70 MILLION YEARS. 

When the PF11 key is pressed, the line is split in two: r- 

===== BIRD SPECIES HAVE DWINDLED _ 

===== IN THE LAST 70 MILLION YEARS. [ 

Now there's room to add information on the line: [ 

===== BIRD SPECIES HAVE DWINDLED FROM 1.5 MILLION TO 10,000_ r 
===== IN THE LAST 70 MILLION YEARS. ^ 



Pressing the PF11 key joins two lines at the cursor position, when the 
cursor is positioned after the end of the data in a line. 

For example: 

===== These lines are _ 
===== too short. 

Note the cursor position above, after the end of the data. Pressing the 
PF11 key produces the following line: 

===== These lines are too short. 

The PF11 key also takes care of leading blanks when a line is split or 
joined. 
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For example: 

===== Things get worse under pressure. 

When the line is split, the second line lines up under the first: 



===== Things get worse _ 
===== under pressure. 

The same is true when lines are joined: 



===== Join these _ 
_J ===== lines without leading blanks 

2] The leading blanks are removed: 



I] = ™ 

J Scrolling Backward and Forward 



Join these lines without leading blanks 



3 

3 
3 
3 
3 

_] Redisplaying a Subcommand 



When a file is too long to fit on one screen, you can use the PF7 and PF8 
keys to scroll back and forth through the file. 

Pressing the PF7 key, which is set to the BACKWARD subcommand, scrolls 
the screen backward, toward the top of the file, for one screen display. 



Conversely, pressing the PF8 key, which is set to the FORWARD 
subcommand, scrolls the screen forward, toward the end of the file, for one 
screen display. 

You can press either key repeatedly to scroll back or forth for as many 
screens as you wish. 



_] After a subcommand that has been typed in the command line is executed, 

_ the command line is cleared. Sometimes, you'd like to be able to see the last 

_J subcommand that was executed. Perhaps you didn't enter a subcommand 

_ the way you intended to. 

_ Pressing the PF6 key (which is set to the ? subcommand) displays, in the 

I command line, the last subcommand that was executed (from the command 

line). 

3 

You can then reexecute the subcommand simply by pressing the ENTER 

J key. If the subcommand was entered incorrectly, you can correct the error 

_ by typing over the subcommand displayed in the command line and then 

J pressing the ENTER key. 

I] •■ 

( 

3 " 

3 
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Reexecuting a Subcommand 

Use the PF9 key, which is -set to the = subcommand, to reexecute the last 
subcommand entered. The subcommand does not appear in the command l 

line, as it does when the PF6 key (which is set to the ? subcommand) is 
used. ^ 

Each time the PF9 key is pressed, the subcommand is executed, thereby *■ 

saving you the time it takes to retype the subcommand. 

Inserting Words in a Line i 

r 

Using the Insert Mode Key and a NULL Key (PA2) 

i 
One way to insert letters, spaces, or words in a line is by pressing the PA2 
key (or its equivalent) and then by using the insert mode key. The PA2 key l. 

is initially set to NULLKEY. For information about how to change the 
initial PA key settings (SET PAn), please refer to the VM/SP System [ 

Product Editor Command and Macro Reference. 

[ 

The PA2 key replaces blank spaces at the end of a line with null characters; 

it "makes room" for the characters in the line to be shifted over so that new 1 

ones can be inserted. 



The PA2 key operates on only one line at a time; if you move the cursor to 
another line and want to use insert mode, you must press the PA2 key 
again. 

Remember to press the RESET key when you are finished using insert 
mode. 

This method may be used in both input mode and edit mode, but not in 
power typing mode. 



Using the SET NULLS Subcommand 



If you have insertions to make on many lines, you can issue the following 
subcommand: 

====> SET NULLS ON 

Then, you can use the insert mode key without pressing the PA2 key for 
each line. When you are finished inserting words, issue the following 
subcommand: 

====> SET NULLS OFF 
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(In power typing mode, you can use the insert mode key without issuing a ^ r 

SET NULLS ON subcommand and without pressing the PA2 key.) 

r 
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Using Prefix Subcommands 



The following prefix subcommands are described in this section: 



_] I Prefix subcommands are one- or two-character commands used to perform 

basic editing tasks on a particular line. 

I] 
3 

A (add) 
J D (delete) 

_ | SI (structured input) 

_J " (duplicate) 

M (move) 
D C (copy) 

F (following) 
_J P (preceding) 

/ (set current line) 

3 

_ Prefix subcommands are entered by typing over any position of the 

_J five-character prefix area on one or more lines. When the ENTER key is 

pressed, all of the prefix subcommands that have been typed on the screen 
_l are executed. 



Adding and Deleting Lines 



j 

3 ! - 

'^] A Prefix Subcommand 



^J To add a line, type the single character "A" in the prefix area. When the 

ENTER key is pressed, a blank line is inserted immediately following the 

^] line containing the "A". A number may precede or follow the "A" to 

indicate that more than one line is to be added. For example, "A5" causes 
] five blank lines to be added. 

~^\ The following are valid ways to type the A prefix subcommand: 

~~\ ====A Adds one blank line after this line. 

a==== Adds one blank line after this line. 

10a== Adds ten blank lines after this line. 
I ===A5 Adds five blank lines after this line. 

_J Information may then be typed in the added lines. If no information is 

typed, the blank lines remain in the file throughout the editing session and 
_J after the file is written to disk. 

3 
3 

3 

i 

3 ' 

3 
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D Prefix Subcommand 



To delete a line, enter the single character "D" in the prefix area of a line. 

A number may precede or follow the "D" to indicate that more than one 
line is to be deleted. 

To delete a group of consecutive lines, that is, a block of lines, you can 
enter the double character "DD" in the prefix area of both the first and last 
lines to be deleted. This method makes it unnecessary for you to count the 
number of lines to be deleted. 

For example: 

==dd= This is the first line I want to remove. 
===== This is the second. 
===== This is the third. 
===== This is the fourth. 
===dd This is the fifth. 

When the ENTER key is pressed, the above lines are deleted. 

The first and last lines of the block need not be on the same screen; you 
may scroll the screen before entering the second "DD". When one "DD" 
has been typed and the ENTER key pressed, the status area of the screen 
displays ' DD ' pending. . . . You can use the PF7 or PF8 keys to scroll the 
screen until you find the last line of the block, and then type "DD" in its 
prefix area. When the ENTER key is pressed, the entire block of lines is 
deleted. 

Figure 7 is a before-and-after example of the A and D prefix subcommands. 
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ANIMALS FACTS Al F 80 Trunc=80 Size=14 Line=9 Col=l Alt=0 

===== * * * Top of File * * * 

D==== THE HIPPOPOTAMUS IS DISTANTLY RELATED TO THE PIG. 

===== ELEPHANT TUSKS CAN WEIGH MORE THAN 300 POUNDS. 

===== LAND CRABS FOUND IN CUBA CAN RUN FASTER THAN A DEER. 

===== ELECTRIC EELS CAN DISCHARGE BURSTS OF 625 VOLTS, 

=2a== 40 TIMES A SECOND. 

===== THE ANCIENT ROMANS AND GREEKS BELIEVED THAT BEDBUGS HAD MEDICINAL 

===== PROPERTIES WHEN TAKEN IN A DRAFT OF WATER OR WINE. 

==DD= STURGEON IS THE LARGEST FRESHWATER FISH AND CAN WEIGH 2250 POUNDS. 

===== ANTS ARE EQUIPPED WITH FIVE DIFFERENT NOSES. EACH ONE IS DESIGNED TO 

I... + ....1.. .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. ... + .. ..6. ... + .. ..7 
=DD== ACCOMPLISH A DIFFERENT TASK. 
==A== ALL OSTRICHES ARE POLYGAMOUS. 
===== SNAKES LAY EGGS WITH NONBRITTLE SHELLS. 

===== THE PLATYPUS HAS A DUCK BILL, OTTER FUR, WEBBED FEET, LAYS 
===== EGGS, AND EATS ITS OWN WEIGHT IN WORMS EVERY DAY. 
===== * * * End of File * * * 






X E D I T 1 File 



ANIMALS FACTS 



Al F 80 Trunc=80 Size=13 Line=9 Col=l Alt=l 



* * * Top of File * * * 

ELEPHANT TUSKS CAN WEIGH MORE THAN 300 POUNDS. 
LAND CRABS FOUND IN CUBA CAN RUN FASTER THAN A DEER. 
ELECTRIC EELS CAN DISCHARGE BURSTS OF 625 VOLTS, 
40 TIMES A SECOND. 

THE ANCIENT ROMANS AND GREEKS BELIEVED THAT BEDBUGS HAD MEDICINAL 
PROPERTIES WHEN TAKEN IN A DRAFT OF WATER OR WINE. 
ALL OSTRICHES ARE POLYGAMOUS. 
| ...+.... 1. . ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. . .6. . . .+ 

SNAKES LAY EGGS WITH NONBRITTLE SHELLS. 

THE PLATYPUS HAS A DUCK BILL, OTTER FUR, WEBBED FEET, LAYS 

EGGS, AND EATS ITS OWN WEIGHT IN WORMS EVERY DAY. 

* * * End of File * * * 






X E D I T 1 File 



Figure 7. Prefix Subcommands A and D — "Before" and "After" 
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Lost and Found Department 



If you delete one or more lines, you can recover them at any time during an 
editing session by using the RECOVER subcommand. 

The following subcommand returns lines deleted in an editing session: 
====> RECOVER n 

where "n" represents the number of lines you wish to recover. 

Recovered lines are inserted starting at the current line. The last lines 
deleted are the first lines recovered. If the lines were deleted from different 
places in the file, you'll have to put them back where they belong (by using 
the M prefix subcommand, discussed below.) 

If you want to recover all lines that were deleted during an editing session, 
use the form: 

====> RECOVER * 

In the previous example of the A and D prefix subcommands, four lines 
were deleted. Entering, 

RECOVER 2 

results in: 



ANIMALS FACTS Al F 80 Trunc=80 Size=15 Line=9 Col=l Alt=2 
2 line(s) recovered. 

===== * * * Top of File * * * ' . ^ 

===== ELEPHANT TUSKS CAN WEIGH MORE THAN 300 POUNDS. 

===== LAND CRABS FOUND IN CUBA CAN RUN FASTER THAN A DEER. { 

===== ELECTRIC EELS CAN DISCHARGE BURSTS OF 625 VOLTS, 
===== 40 TIMES A SECOND. ,- 

===== THE ANCIENT ROMANS AND GREEKS BELIEVED. THAT BEDBUGS HAD MEDICINAL 

===== PROPERTIES WHEN TAKEN IN A DRAFT OF WATER OR WINE. 

===== ANTS ARE EQUIPPED WITH FIVE DIFFERENT NOSES. EACH ONE IS DESIGNED TO 

| ... + .... 1 + ....2.... + 3. ... + .. . . 4 . ... + .. ..5. ... + .. ..6. ... + .. ..7... [ 

===== ACCOMPLISH A DIFFERENT TASK. 
===== ALL OSTRICHES ARE POLYGAMOUS. 

===== SNAKES LAY EGGS WITH NONBRITTLE SHELLS. 

===== THE PLATYPUS HAS A DUCK BILL, OTTER FUR, WEBBED FEET, LAYS 

===== EGGS, AND EATS ITS OWN WEIGHT IN WORMS EVERY DAY. l 

===== * *■ * End of File * * * 

r 

====> X E D I T 1 File 

L. 

Figure 8. RECOVER Subcommand — Replacing Two Lines [ 

L 

r 
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SI Prefix Subcommand 



To continuously add lines of indented text, type the characters "SI" in the 
prefix area. When the ENTER key is pressed, a line is added immediately 
following the line that contains "SI." The cursor is positioned at the same 
column where the text on the previous line begins, making it easier for you 
to enter indented text. 

Figure 9 shows how the first new line is added. 
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3 
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The prefix subcommand "SI" is typed in the prefix area. 



CHOCOLAT COOKIES Al F 80 Trunc=80 Size=6 Line=6 Col=l Alt=0 



===== * * * Top of File * * * 

===== Chocolate-Nut Cookie Ingredients 

===== 1/2 Pound of butter 

SI=== 1 1/2 Cups of graham cracker crumbs 

_____ ^ 1/2 Ounces coconut flakes 

===== 2 Ounces chopped nuts 

I...+....1.. ..+... .2. ...+.. ..3.. ..+... .4....+. 
===== * * * End of File * * * 






X E D I T 1 File 



When ENTER is pressed a new line is added. 



CHOCOLAT COOKIES Al F 80 Trunc=80 Size=7 Line=6 Col=l Alt=0 



* * * Top of File * * * 
Chocolate-Nut Cookie Ingredients 

1/2 Pound of butter 

1 1/2 Cups of graham cracker crumbs 

3 1/2 Ounces coconut flakes 
| . . . + 1 + 2 + 3 + 4. 

2 Ounces chopped nuts 

* * * End of File * * * 



+ 






i i 



pending, 



Figure 9. Prefix Subcommand SI — Adding the First New Line 
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Text is entered on the new line. 



| CHOCOLAT COOKIES Al F 80 Trunc=80 Size=7 Line=6 Col=l Alt=l 



* * * Top of File * * * 
Chocolate-Nut Cookie Ingredients 

1/2 Pound of butter 

1 1/2 Cups of graham cracker crumbs 

8 Ounces sweetened condensed milk_ 
3 1/2 Ounces coconut flakes 
I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5 

2 Ounces chopped nuts 

* * * End of File * * * 






When ENTER is pressed, a new line is automatically added following the one 
you just typed on. Each time that you type on the new line and press the 
ENTER key, another new line will be added. 



1 pending, 



3 
'3] 



CHOCOLAT COOKIES Al F 80 Trunc=80 Size=8 Line=6 Col=l Alt=l 



3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 



* * * Top of File * * * 
Chocolate-Nut Cookie Ingredients 

1/2 Pound of butter 

1 1/2 Cups of graham cracker crumbs 

8 Ounces sweetened condensed milk 

| . . . + IT. . . + 2 + 3 + 4. 

3 1/2 Ounces coconut flakes 

2 Ounces chopped nuts 

* * * End of File * * * 



+ , 






Figure 10. Prefix Subcommand SI — Continuing to Add New Lines 



' pending, 
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If you do not want to add more lines, then press the ENTER key one more 
time without typing anything on the new line. 

CHOCOLAT COOKIES Al F 80 Trunc=80 Size=7 Line=6 ' Col=l Alt=l 



* * * Top of File * * * 
Chocolate-Nut Cookie Ingredients 

1/2 Pound of butter 

1 1/2 Cups of graham cracker crumbs 

8 ' Ounces sweetened condensed milk 

3 1/2 Ounces coconut flakes 
I... + ....1.. .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. ... + .. ..6. ... + .. ..7 

2 Ounces chopped nuts 

* * * End of File * * * 






X E D I T 1 File 



Figure 11. Prefix Subcommand SI - "After' 



c 
, r 
r 
r 
r 
r 
r 
r 
r 
r 
[' 
r 
r 
c 

=3"== I want three more copies of this line. 

===== oh, yeah? ^ T 

When the ENTER key is pressed, the file looks like this: [ 
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Duplicating Lines 



To add a blank line in a file while using SI, make at least one change on 

the line that contains " ". (Pressing the spacebar once will 

change the line.) Merely moving the cursor using the cursor position keys 
over a line does not change the line. 

You can leave the line you are adding and make corrections elsewhere in 
the file if you type something on the new line first. When you press the 
ENTER key while the cursor is away from the new line, another new line is 
added following the last line that was added. SI will only be canceled if you 
press ENTER and no text has been typed on the new line. 



To duplicate a line, enter the character " (double quote) in the prefix area 
of a line. 

A number may precede or follow the " to duplicate the line more than one 
time. 

For example: 



3 



<= \p > u 



===== I want three more copies of this line. 
_ 1 ===== i want three more copies of this line. 

— ' ===== i want three more copies of this line. 

===== I want three more copies of this line. 
_J ===== oh, yeah? 

_J To duplicate a block of lines either one time or a specified number of times, 

_ you can type " " (two double quotes) in the first and last lines of the block. 

J A number can precede or follow the first " " (for example, 5" ") to duplicate 

the block more than one time. 

3 

When one " " has been typed and the ENTER key pressed, the status area of 
_J the screen displays '""' pending.... This allows you to scroll the 

screen before completing the block and pressing the ENTER key. 

^] Moving and Copying Lines 

_J To move one line, enter the single character "M" in the prefix area of the 

line to be moved. You must indicate its destination by entering either the 

_] character "F" (following) or "P" (preceding) in the prefix area of another 

line. 

II 

When the ENTER key is pressed, the line containing the "M" is removed 
_] from its original location and is inserted in one of the following: 

_] • immediately following the line containing the "F" 

_] © immediately preceding the line containing the "P." 

^] A number may precede or follow the "M" to indicate that more than one 

line is to be moved, for example, "5M" or "M5" in the prefix area. 

II 

The line to be moved and the destination line can be on different screens. 
_] When either an "M" or "F" (or "P") has been entered, the status area of the 

screen displays a pending notice. This pending status allows you to scroll 
__] the screen before entering the other prefix subcommand. 

. 1 To move a block of lines, enter the double character "MM" in the prefix 

area of both the first and last lines to be moved. The first and last lines to 

I be moved, and the destination line may all be on different screens. You can 

_ use PF keys to scroll the screen before pressing the ENTER key. 

_ The procedure for copying lines is the same as for moving lines, except that 

_] a "C" or "CC" prefix subcommand is used instead of "M" or "MM". The 

copy operation leaves the original line(s) in place, and makes a copy at the 
) destination line, which must be indicated by "F" or "P". 

— J Figure 12 is a before-and-after example of the M prefix subcommand. 



u 
II 

3 
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Setting the Current Line (/) 



Many subcommands begin their operations starting with the current line. 
For example, the INPUT subcommand makes room for you to enter data 
after the current line. You have already seen the INPUT subcommand used 
to insert lines after the Top of File line. 

The / (diagonal) prefix subcommand can be typed in the prefix area of any 
line on the screen. When the ENTER key is pressed, that line becomes the 
current line. Then, if you enter an INPUT subcommand, the new lines 
entered in input mode will be inserted between the current line and the line 
that followed it. 



Canceling Prefix Subcommands 



If you have entered one or more prefix subcommands that create a pending 
status, you can cancel all these prefix subcommands by entering the 
following subcommand in the command line: 






RESET 



When the ENTER key is pressed, all prefix subcommands disappear from 
the display and the prefix areas are restored with equal signs (= = = = =). 

If you have typed any prefix subcommands (even those that do not cause a 
pending status) but have not yet pressed the ENTER key, you can press the 
CLEAR key to remove them. 
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ANIMALS FACTS Al V 132 Trunc=132 Size=22 Line=10 Col=l Alt=0 



===== CHAMELEONS, REPTILES THAT LIVE IN TREES, CHANGE THEIR COLOR WHEN 

===== EMOTIONALLY AROUSED. 

===== THE GUPPY IS NAMED AFTER THE REVEREND ROBERT GUPPY, WHO FOUND THE FISH 

===== ON TRINIDAD IN 1866. 
"I ===== AN AFRICAN ANTELOPE CALLED THE SITATUNGA HAS THE RARE ABILITY TO 

~ J ===== SLEEP UNDER WATER. 

.... =mm== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 

_J ===== SQUID. 

===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 
~] ===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

-1 | ... + .... 1 . . .. + ... .2. ... + .. ..3. ...+.. . . 4 . ...+.. ..5. ... + .. ..6. ... + .. . . 7 . 

===mm HAS ON THE SHARKS. 
■] ===== A LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

- 1 ===== ACROSS WATER. 

_, ===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

_j ===== LEARNING. 

f==== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY, 
--i ===== a FISH CALLED THE NORTHERN SEA ROBIN MAKES NOISES LIKE A WET 

-J ===== FINGER DRAWN ACROSS AN INFLATED BALLOON. 

===== STINGAREES, FISH FOUND IN AUSTRALIA, CAN WEIGH UP TO 800 POUNDS. 

X E D I T 1 File 



ANIMALS FACTS Al V 132 Trunc=132 Size=22 Line=7 Col=l Alt=l 



* * * Top of File * * * 

CHAMELEONS, REPTILES THAT LIVE IN TREES, CHANGE THEIR COLOR WHEN 



EMOTIONALLY AROUSED, 



"I ===== THE GUPPY IS NAMED AFTER THE REVEREND ROBERT GUPPY, WHO FOUND THE FISH 

~ J ===== ON TRINIDAD IN 1866. 

===== AN AFRICAN ANTELOPE CALLED THE SITATUNGA HAS THE RARE ABILITY TO 
J ===== SLEEP UNDER WATER. 

===== a LIZARD OF CENTRAL AMERICA CALLED THE BASILISK CAN RUN 

I... + ....1.. .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. ... + .. ..6. ... + .. ..7., 

===== ACROSS WATER. 

===== OCTOPI HAVE LARGE BRAINS AND SHOW CONSIDERABLE CAPACITY FOR 

===== LEARNING. 

===== THE LION ROARS TO ANNOUNCE POSSESSION OF A PROPERTY. 

===== THE KILLER WHALE EATS DOLPHINS, PORPOISES, SEALS, PENGUINS, AND 
J ===== SQUID. 

===== ALTHOUGH PORCUPINE FISHES BLOW THEMSELVES UP AND ERECT THEIR SPINES, 

===== THEY ARE SOMETIMES EATEN BY SHARKS. NO ONE KNOWS WHAT EFFECT THIS 

===== HAS ON THE SHARKS. 

X E D I T 1 File 



Figure 12. Prefix Subcommands M and F — "Before" and "After' 



Chapter 1. An XEDIT Subset: Full-Screen Text Processing 25 




Moving through a File 



The following subcommands are discussed in this section: 

BACKWARD 

FORWARD 

TOP 

BOTTOM 

UP 

DOWN 



BACKWARD and FORWARD Subcommands 



Scrolling the screen is like turning the pages of a book. You have already L 

seen that the PF7 and PF8 keys are set to the BACKWARD and FORWARD 
subcommands, which scroll one full screen backward or forward. The { 

BACKWARD and FORWARD subcommands can also be entered in the 
command line. [ 

The format of these subcommands is: L 

====> BACKWARD n 
====> FORWARD n 

r 

where "n" is the number of screen displays you want to scroll backward or ' 

forward. (This is like pressing the PF7 or PF8 key "n" times.) If you omit r 

"n," the editor scrolls one screen backward or forward. 



If you enter a BACKWARD subcommand when the current line is the "Top 
of File" line, the editor "wraps around" the file, making the last line of the 
file the new current line. Similarly, if you enter a FORWARD subcommand 
when the current line is the "End of File" line, the editor makes the first 
line of the file the new current line. 



TOP and BOTTOM Subcommands 



Suppose the file is many screens long, and the current screen display is 

somewhere in the middle of the file. To go back to the beginning of the file, i 

you could enter multiple BACKWARD subcommands — or — you could 

enter the TOP subcommand. The TOP subcommand makes the "Top of ' 

File" line the new current line. Its format is: r . 

{ 
====> TOP 

r 

The BOTTOM subcommand makes the last line of the file the new current 

line. Its format is: t 

====> BOTTOM 



26 VM/SP System Product Editor User's Guide 



3 



— I 



~1 

— ) 




3 



— i 



3 



n 



These subcommands are useful when you want to insert new lines either at 
the beginning or end of a file. The TOP subcommand followed by an 
INPUT or POWERINP subcommand makes room for you to add lines at the 
beginning of a file; use the BOTTOM subcommand followed by INPUT or 
POWER to add lines to the end of a file. 



DOWN and UP Subcommands 



Suppose that you want to move the file up or down a few lines instead of a 
whole screen. The DOWN subcommand advances the line pointer one or 
more lines toward the end of a file. The line pointed to becomes the new 
current line. For example: 

====> DOWN 5 



3 



3 



3 



makes the fifth line down from the current line the new current line. If the 
number is omitted, "1" is assumed. 

The UP subcommand moves the line pointer toward the beginning of the 
file. The line pointed to becomes the new current line. For example: 

====> UP 5 

makes the fifth line up from the current line the new current line. If a 
number is omitted, "1" is assumed. 

Figure 13 is a before-and-after example of the DOWN subcommand. 
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PURIST 



SCRIPT 



Al V 132 Trunc=132 Size=12 Line=5 Col=l Alt=0 



* * * Top of File * * * 
"THE PURIST" 

I GIVE YOU NOW PROFESSOR TWIST. 

A CONSCIENTIOUS SCIENTIST. 

TRUSTEES EXCLAIMED, "HE NEVER BUNGLES!" 

| ... + ... .1. . .. + ... .2.... + 3.... + ... .4. 

AND SENT HIM OFF TO DISTANT JUNGLES. 
CAMPED ON A TROPIC RIVERSIDE, 
ONE DAY HE MISSED HIS LOVING BRIDE. 
SHE HAD, THE GUIDE INFORMED HIM LATER, 
BEEN EATEN BY AN ALLIGATOR. 
PROFESSOR TWIST COULD NOT BUT SMILE. 
"YOU MEAN," HE SAID, "A CROCODILE." 

* * * End of File * * * 



====> DOWN 5 



X E D I T 1 File 



PURIST SCRIPT Al V 132 Trunc=132 Size=12 Line=10 Col=l Alt=0 

===== "THE PURIST" 

===== j GIVE YOU NOW PROFESSOR TWIST. 

===== a CONSCIENTIOUS SCIENTIST. 

===== TRUSTEES EXCLAIMED, "HE NEVER BUNGLES!" 

===== AND SENT HIM OFF TO DISTANT JUNGLES. 

===== CAMPED ON A TROPIC RIVERSIDE, 

===== ONE DAY HE MISSED HIS LOVING BRIDE. 

===== SHE HAD, THE GUIDE INFORMED HIM LATER, 

===== BEEN EATEN BY AN ALLIGATOR. 

| ... + ... .1. . .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5 + ....6. 

===== PROFESSOR TWIST COULD NOT BUT SMILE. 
===== "YOU MEAN," HE SAID, "A CROCODILE." 
===== * * * .End of File * * * 






X E D I T 1 File 



Figure 13. The DOWN Subcommand - "Before" and "After' 
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Making Changes in a File 



H When you're looking at a screen of data that you have just entered and 

decide to make some changes, it's easy to type over the information to be 
2] changed. 

_ J However, it's not always that simple. Typically, you have numerous files 

stored on direct access devices and need to make changes even though you 
^J don't know exactly where the data is located in a file. 

_] The challenge is two-fold: find the data; then change it. 

~_J The following subcommands are discussed in this section: 

'J CLOCATE 

CHANGE 
J CINSERT 

CFIRST 

"J 



CLOCATE Subcommand 



~1 The CLOCATE subcommand searches a file, beginning with the column 

after the current column in the current line, for a character string that you 
"1 specify. 



1 If the string is located, two things happen: 

"""] • The line containing the string becomes the new current line; however, if 

~ the string is in the current line, the line pointer does not move. 

""! 

• The column pointer, represented in the scale as a vertical bar (|), moves 

~] under the first character of the string. 

"] These changes are reflected in the file identification area at the top of the 

screen (Line = nnn and Col = nn). 

3 

3 
3 
3 
3 
3 

3 . 

{ 
-j ... 

3 
3 



One format of the CLOCATE subcommand is as follows: 
====> CLOCATE/string/ 

The string should be enclosed in delimiters. In the examples used in this 
book, the delimiter is a diagonal (/); however, you can use any character 
except for a plus ( + ), minus ( — ), not (~i), or period (.) that does not appear 
in the string itself (for example, CLOCATE7VM/CMS?). 

In the following example, the string to be located is in the current line. 
Therefore, the line pointer does not move, but look what happens to the 
column pointer: 
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===== To be or not to be - that is the question. 

I... + ....1.. .. + ... .2. ... + .. ..3.. .. + ... .4. ... + .. ..5.... 

====> CLOCATE/be/ 

===== To be or not to be - that is the question. 

<. . | + 1 + 2 + 3 + 4 + 5 

Notice that the column pointer in the scale has moved under the first 
character (b) in the string (be). 

If you wanted to find all occurrences of "be" throughout the file, you could 
enter the CLOCATE/be/ subcommand repeatedly (or use the PF9 key, which 
is set to the = subcommand, for repeated execution). If a string appears 
more than once in a line, as in the example above, the line pointer remains 
the same, but the column pointer moves under the next occurrence of the 
string. 

For example, if the CLOCATE/be/ subcommand is entered again, the line 
looks like this: 

===== To be or not to be - that is the question. 

<... + 1 + . | . .2 + 3 + 4 + 5 

Note the position of the column pointer, under the second "be". 

Each time the CLOCATE/be/ subcommand is entered, the column pointer 
moves under the next occurrence of "be"; in addition, the line pointer 
advances, until all occurrences of "be" have been found. 

If the string tha£ you're searching for is in a backward direction from the 
current line, toward the top of the file, you can tell the editor to search 
backward by typing a minus sign ( — ) in front of the string. For example: 

====> CLOCATE -/glance/ 
is a backward search for "glance". 



CHANGE Subcommand 



Replacing one word with another is the simplest type of change. If the 
string you want to change is not in the current line, you can use the 
CLOCATE subcommand to move the line pointer to the line that contains 
the string. Then, you can use the following form of the CHANGE 
subcommand, which changes the first occurrence of a word in the current 
line: 






CHANGE/o ldwor d/newwor d/ 



For example: 
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===== A rose is a rose is a rose. 

| . . . + 1 + 2 + 3 + ... 

====> CHANGE/rose/daisy/ 

(with apologies to Gertrude Stein) 

===== A daisy is a rose is a rose. 

| . . . + 1 + 2 + 3 + ... 

Note that the editor automatically made room in the line for "daisy" even 
though it is longer than "rose". Conversely, a word can be replaced by a 
shorter word; the editor removes extra blanks. 

You can use the CLOCATE and CHANGE subcommands to locate and 
change any string in a file. If the line containing the string is the current 
line, you don't have to use a CLOCATE subcommand; the CHANGE 
subcommand both locates and changes it. 



Making a Selective Change 



Suppose you want to change one word to another only some of the time, 
that is, you want to make a selective, or "safe" change. You can do this by 
locating (repeatedly) the string you want to change, and by entering a 
CHANGE subcommand only when you want to change the string. 
However, there's an easier way. 

All you have to do is type a CHANGE subcommand (in the form 
CHANGE/oldword/newword/) in the command line. Then, use the PF5 key 
to locate each occurrence of the old word, examine it, and then either 
change it (by pressing the PF6 key), or go on to the next occurrence (by 
pressing the PF5 key). 

Here's how to make a selective change: 

1. Move the line pointer to the line where you want the search to begin. 
(You can use TOP, /, DOWN, or UP.) 

2. Type a CHANGE subcommand (CHANGE/oldword/newword/) in the 
command line, but don't press the ENTER key. 

3. Press the PF5 key. The cursor moves under the first occurrence of the 
old word, and the line that contains it is highlighted. 

4. If you want to change the word, press the PF6 key. If not, press the 
PF5 key again, and step number 3 (above) will be repeated. 

Using this sequence, you can locate all the occurrences of the old word, and 
press the PF6 key to change it only when desired. When all occurrences of 
the old word on one screen have been located, the editor scrolls the screen 
forward automatically. 
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Figure 14 is an example of using the PF5 and PF6 keys to locate and 
change selectively a character string throughout a file. The following 
subcommand was typed in the command line but the ENTER key was not 
pressed: 






CHANGE/rose/daisy/ 



This subcommand is executed when the PF6 key is pressed. 

In the top screen, pressing the PF5 key has placed the cursor (and the 
column pointer) under the first occurrence of "rose". 

In the bottom screen, the PF5 key was pressed successively until the last 
occurrence of "rose". Then the PF6 key was pressed to execute the change 
specified in the command line. 

If you want to locate all occurrences of a string, but you don't want to 
make any changes, you can type a CLOCATE/string/ subcommand instead 
of a CHANGE subcommand. Then, each time you press the PF5 key, the 
cursor moves under the next occurrence of the string and the line is 
highlighted. Pressing the PF6 key has no effect. 

For more information on making a selective change, see "SCHANGE" in 
the VM/SP System Product Editor Command and Macro Reference. 
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31 
33 
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3] 
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J 

3\ 
31 

33 
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ROSE PETALS Al 
String /ROSE/ found. ■ 



F 80 Trunc=80 Size=ll Line=l Col=3 Alt=0 
■- PF6 set for selective change. 



= = * * * TOP 

== A ROSE IS 

== A ROSE IS 

== A ROSE IS 

== A ROSE IS 

== A ROSE IS 

== A ROSE IS 

== A ROSE IS 

: = A ROSE IS 

== A ROSE IS 

== A ROSE IS 



of File * * 

A ROSE IS A 

1 + 2. , 



A ROSE 
A ROSE 
A ROSE 
A ROSE 
A ROSE 
A ROSE 
A ROSE 
A ROSE 
A ROSE IS 



IS A 
IS A 
IS A 
IS A 
IS A 
IS A 
IS A 
IS A 



ROSE 

. . + . , 

ROSE, 

ROSE, 

ROSE, 

ROSE 

ROSE, 

ROSE, 

ROSE, 

ROSE, 

ROSE 



Macro-read 1 File 



ROSE PETALS Al F 80 Trunc=80 Size=ll Line=10 Col=23 Alt=l 
String /ROSE/ changed to /DAISY/ 



: = * * * Top 
== A ROSE IS 

== A ROSE IS 
: = A ROSE IS 
== A ROSE IS 
== A ROSE IS 
: = A ROSE IS 
: = A ROSE IS 
: = A ROSE IS 
== A ROSE IS 
== A ROSE IS 
= > 



of File * * 

A ROSE IS A 

1 + 2. . 



A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 

A ROSE IS A 



ROSE. 
| .+. . , 
ROSE. 
ROSE. 
ROSE. 
ROSE. 
ROSE. 
ROSE. 
ROSE. 
ROSE. 
DAISY, 



Macro-read 1 File 



Figure 14. Using PF5 and PF6 to Make a Selective Change 
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Making a Global Change 



If you want to make a global change, that is, change every occurrence of a 

word throughout the file, first make sure that the first line of the file is the ^ 

current line and use the following form of the CHANGE subcommand: r- 

====> CHANGE/oldword/newword/ * * 

[" 

For example: 

[ 
===== * * * Top of File * * * 

===== A rose is a rose is a rose. r ~ 

===== A rose is a rose is a rose. ' 

===== A rose is a rose is a rose. 

===== A rose is a rose is a rose. [ 

===== * * * End of File * * * 

====> CHANGE/rose/daisy/ * * ^ 

===== * * * Top of File * * * i 

===== A daisy is a daisy is a daisy. 

===== A daisy is a daisy is a daisy. [ 

===== A daisy is a daisy is a daisy. 

===== A daisy is a daisy is a daisy. r 

===== * * * En( j of File * * * L 

This form of the CHANGE subcommand can also be used to make a global ^ 
change starting in the middle of a file. Since the change starts with the 

current line, you would just make current (via /) that line where you want ^ 

the change to begin. r- 

Another variation of the CHANGE subcommand can be used if you want to 
change a word throughout the file, but you want to change only the first 
occurrence in each line: 



====> CHANGE/oldword/newword/ 

CINSERT Subcommand 



Often, you need to insert words in a line. You have already seen how to [~ 

use the PA2 and insert mode keys and the SET NULLS subcommand. 

Another way to insert words is by using the CINSERT subcommand, which [~ 

allows you to insert characters in the current line immediately before the 

column pointer. [ 

You can use a CLOCATE/string/ subcommand to move the column pointer [~ 

to the desired position. You can also use another form of the CLOCATE 

subcommand to move the column pointer: r 

====> CLOCATE :n 



where ":n" represents an absolute column number, easily determined by 
looking at the scale. 
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For example: 

===== To be or not to be - that is the question. 

|... + ....l. ... + ... .2. ... + .. ..3.. .. + ... .4... . + ....5.... 

====> CLOCATE :4 

===== To be or not to be - that is the question. 

<..|+....l....+....2....+....3....+....4....+....5.... 

The column pt inter has moved to column four. 

In the following example, the CLOCATE subcommand is used to move the 
column pointer; then the CINSERT subcommand is used to insert 
characters immediately before the column pointer position. 

===== If anything can go, it will. 

| . . . + 1 + 2 + 3 + 4 + 5 

====> CLOCATE/,/ or ====> CLOCATE : 19 

(move the column pointer) 

===== If anything can go, it will. 

<...+....l....+...|2....+....3....+....4....+....5.... 

====> CINSERT wrong 

(insert "wrong" before the column pointer) 

===== If anything can go wrong, it will. 

<...+....l....+...|2....+....3....+....4....+....5.... 

(In the CINSERT subcommand above, note that there are two spaces 
between "CINSERT" and "wrong": one is the required space between the 
subcommand name and the operand; one is the blank space needed between 
"go" and "wrong".) 

If only one blank space were used, the result would be the following: 

===== If anything can gowrong, it will. 

The editor allows you to insert blanks with the CINSERT subcommand — 
simply type the required number of blanks (by pressing the spacebar) in the 
operand. For example: 

===== If anything can go wrong, it will. 

====> CLOCATE/can/ 
====> CINSERT 

(Press the spacebar six times.) 
===== If anything can go wrong, it will. 



3 
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If the inserted characters make the line longer than the screen line, the 
editor automatically "wraps around" to the next line. Characters can be 
inserted up to the truncation column, as shown in the following example: 



It takes less time to do a thing than to explain why you did it. 
J...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6... .+. 



====> CLOCATE/than/ 
(move the column pointer) 



===== It takes less time to do a thing than to explain why you did it. 

<... + 1 + 2 + 3 ... | + 4 + ....5 + 6 + ....7 

====> CINSERT right 

(insert the first word. You must type one blank after "right" 
to avoid "rightthan" . ) 



===== It takes less time to do a thing right than to explain why you did it. 

<... + 1 + 2 + 3 ... | + .... 4 + ....5 + 6 + ....7... 

====> CLOCATE/./ 

(move the column pointer again) 

===== It takes less time to do a thing right than to explain why you did it. 

<...+. ...1. ...+....2.. ..+... .3.. ..+... .4. ...+.. ..5....+.. ..6. ...+.... | .. . 

====> CINSERT wrong 

(insert the second word) 

===== It takes less time to do a thing right than to explain why you did it wron 



Even though the resulting line is longer than a screen line, it is considered 
to be one logical line. 

Notice that the line has one prefix area associated with it. Any prefix 
subcommands entered in the prefix area affect the entire logical line. For 
example, if a D prefix subcommand is entered, the whole sentence is 
deleted. 

CFIRST Subcommand 

After using subcommands that move the column pointer, it's a good idea to 
reset the column pointer to column one by issuing the CFIRST 
subcommand. 

For example: 
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Setting Tabs 



: = If anything can go wrong, it will. 
<...+....l....+.|..2....+....3... .+. 

= > CFIRST 

: = If anything can go wrong, it will. 
I ... + ... .1. ... + ... .2. ... + ... .3. .. .+ 



Sometimes you may want to place information in specific columns. The 
PF4 key functions like a tab key on a typewriter. Each time the PF4 key is 
pressed, the cursor is positioned under the next tab column, where you can 
enter data. 

Initial tab settings are defined by the editor according to filetype; they may 
be displayed by using the following subcommand: 

====> QUERY TABS 

You can change these settings one or more times during an editing session 
with the SET TABS subcommand. For example: 

====> SET TABS 10 20 30 

The first time the PF4 key is pressed, the cursor moves to column 10 on the 
screen. The second time, it moves to column 20, and so forth. 

The PF4 key may be used for tabbing in input mode, but not in power 
typing mode. 

You can change the tab settings by issuing another SET TABS 
subcommand, or, if you'd like to see the current tab settings before 
changing them, you can use the following subcommand: 

====> MODIFY TABS 

The current SET TABS subcommand is then displayed in the command line; 
you can type over the numbers and press the ENTER key to define new 
tabs. 

Figure 15 is an example of data that was entered using the PF4 key as a tab 
key. The following subcommand was used to define the tab columns: 

====> SET TABS 5 35 45 
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TABS 



EXAMPLE Al F 80 



* * * Top of File * * 

TEN COLDEST CITIES 

1. 
2. 
3. 
4. 
5. 
6. 
| ... + . 
7. 
8. 
9. 

10. 

* * * 



ULAN-BATOR, MONGOLIA 
CHITA, U.S.S.R. 
BRATSK, U.S.S.R. 
ULAN-UDE, U.S.S.R. 
ANGARSK, U.S.S.R. 
IRKUTSK, U.S.S.R. 
. .1 + 2 + . . . 



KOMSOMOLSK, U.S.S.R. 
TOMSK, U.S.S.R. 
KEMEROVO, U.S.S.R. 
NOVOSIBIRSK, U.S.S.R. 
End of File * * * 



Size=13 Lin 


e=9 Col=l 


Alt=0 


AVERAGE TEMPERATURE 




(F) 


(C) 




24.8 


-4.0 




27.1 


-2.7 




28.0 


-2.2 




28.9 


-1.7 




29.7 


-1.3 




30.7 


-1.1 




...+... .4. . . 


.+. . . .5. . 


. + . . . 


30.7 


-0.7 




30.9 


-0.6 




31.3 


-0.4 




31.8 


-0.1 








Figure 15. Using the PF4 Key for Tabbing 



X E D I T 1 File 



Ending an Editing Session 



The following subcommands are discussed in this section: 

FILE 
QUIT 
SET AUTOSAVE 



FILE Subcommand 



When you use the XEDIT command to create a new file, the file is created 
in virtual storage. When you make changes to an existing file, those 
changes are made to a copy of the file that is brought into virtual storage 
(when the XEDIT command is entered). However, virtual storage is 
temporary. To write a new or modified file on disk, which is permanent 
storage, you must enter the following subcommand: 

====> FILE 



When the FILE subcommand is executed, the file is written on disk and 
control is returned to CMS. 
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QUIT Subcommand 



3 

3 
3 
3 

^] ====> QUIT 



Use the QUIT subcommand to end an editing session and leave the 
permanent copy of the file intact on the disk. If the file is new, it is not 
written on disk. 

You can execute the QUIT subcommand either by pressing the PF3 key or 
by entering it on the command line, like this: 



_J You would use the QUIT subcommand instead of the FILE subcommand 

when you edit a file merely to examine, but not to change, its contents, or if 

_J you discover you have made errors in changing a file and do not want them 

to be recorded. 

3 



If a file is new or has been changed, the editor gives you a warning message 
to prevent the inadvertent use of a QUIT instead of a FILE. The message is 
as follows: 

File has been changed. Use QQUIT to quit anyway. 



3 

If you really don't want to save the file, enter "QQUIT" (abbreviated as 
^] "QQ"). If you wish to save the changes, enter "FILE". 



SET AUTOSAVE Subcommand 



Files on disk are not affected if the system malfunctions, or "goes down." 
However, a new file that you're creating or the changes you're making to 
an existing file might be lost if the system fails. You can minimize this 
danger by using the SET AUTOSAVE subcommand, whose format is as 
follows: 

SET AUTOSAVE n 



.—J The SET AUTOSAVE subcommand causes your file to be written to disk 

automatically, after you've typed in or changed a certain number of lines. 

— I You specify what that number will be with the "n" operand of the SET 

AUTOSAVE subcommand. If you want the file written to disk, or "saved," 

— I every time you've changed ten lines, enter the following subcommand: 

^] SET AUTOSAVE 10 

_J The number of alterations you have made to your file since the last 

AUTOSAVE will be displayed in the alteration count (Alt = n) in the file 
identification line. When the alteration count is equal to the AUTOSAVE 
setting, the file is saved on disk and the alteration count is reset to zero. 

The SET AUTOSAVE subcommand can be issued at any time during an 
editing session. It's a good idea, however, to issue the subcommand right 
I, after you issue an XEDIT command to create a new file or to call an 

existing file from disk. 
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When a file is saved on disk by AUTOSAVE, it is written into a new file. 
The filename of this file is a number and its filetype is "AUTOSAVE." If 
the system goes down while you're editing a file, you can change the fileid 
back to its original filename and filetype by issuing the CMS command 
ERASE to erase the original file and then by issuing the CMS command 
RENAME. 

For example, if your AUTOSAVE file is labeled "100001 AUTOSAVE Al" 
and the original file is "INVENTOR SCRIPT Al," use the following CMS 
commands to rename it: 

ERASE INVENTOR SCRIPT 

RENAME 100001 AUTOSAVE Al INVENTOR SCRIPT Al 

Then you'll be back in business and can use the XEDIT command to start 
editing the file again. 

If you issue a SET AUTOSAVE subcommand while you're creating a new 
file, and then issue a QUIT subcommand, the file is not saved. However, 
the AUTOSAVE file is available on disk. If you issue a SET AUTOSAVE 
subcommand while you're revising an existing file and then you issue a 
QUIT subcommand, no revisions are saved. However, the AUTOSAVE file 
is still available on disk. 



Inserting Data From Another File 



To insert all or part of one file into another file, you can use the GET 
subcommand. The chapters in this book were created as separate files and 
then combined into one file by using the GET subcommand. 

The GET subcommand inserts another file after the current line in the file 
you are editing. Therefore, you must move the line pointer to the desired 
line of the file. For example, if you want to insert another file at the end of 
a file, you can use the BOTTOM subcommand. If you want to insert 
another file in the middle of a file, you can use the / prefix subcommand to 
make the desired line current. 



Inserting a Whole File 



Suppose you were writing a cookbook, and you created a separate file for 
each recipe. To combine two of the recipes into one file, you would use the 
following form of the GET subcommand: 

====> GET filename filetype 

Figure 16 shows how the GET subcommand is used to insert one whole file 
at the end of another file: 
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The top screen shows a file (DESSERT COOKBOOK) that contains a recipe 
for cream puffs. A recipe for almond cookies is contained in another file, 
COOKIES COOKBOOK. 

The following subcommand was entered: 

====> GET COOKIES COOKBOOK 

In the bottom screen, the message "EOF reached" indicates that the entire 
file has been inserted. Notice that the last line inserted becomes the new 
current line. The file DESSERT COOKBOOK now contains two recipes. 
The file COOKIES COOKBOOK is left intact. 



3 
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3 
3 
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DESSERT COOKBOOK Al F 80 Trunc=80 Size=8 Line=9 Col=l Alt=0 

===== * * * Top of File * * * 

===== CREAM PUFFS WITH CHOCOLATE SAUCE 

===== 2 OUNCES BUTTER 

===== 1/2 TEASPOON SUGAR 

===== 1/2 CUP FLOUR 

===== PINCH OF SALT 

===== 2 EGGS 

===== 2 CUPS HEAVY CREAM, WHIPPED 

===== * * * En d of File * * * 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. 



====> GET COOKIES COOKBOOK 



X E D I T 1 File 



DESSERT COOKBOOK Al F 80 Trunc=80 Size=15 Line=15 Col= 
EOF reached. 

===== PINCH OF SALT 

===== 2 EGGS 

===== 2 CUPS HEAVY CREAM, WHIPPED 
===== ALMOND COOKIES 

===== 6 TABLESPOONS SOFT BUTTER 

===== 1/2 CUP SUGAR 

===== 2 EGG WHITES 

===== 1 PINCH SALT 

===== 1 CUP ALMONDS, SLICED 

I... + ....1.. .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. 

===== * * .* En d f F iie * * * 



= 1 Alt=l 






Figure 16. Inserting a Whole File 



X E D I T 1 File 
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Inserting Part of Another File 



1] 
3 

'} 

-j 

J 
I] 

To insert part of another file, you can specify in the GET subcommand the 
_J line number of the first line and the number of lines you want to insert. 

The following GET subcommand inserts the first ten lines of a second file: 

====> GET FILE2 DATA 1 10 

If you don't know the line numbers, you can: call out a second file without 
~] ending your current editing session; put the lines you want to insert into a 

temporary file; and insert them into your current file. 

J 

This might sound complicated, but all you need to learn is one more 
~J] subcommand — PUT. 

_J First, let's identify and explain the steps you would take to insert part of 

another file and then illustrate them with an example. 

H 

1. While editing the first file, enter an XEDIT subcommand to call out the 
^] second file. (You do not have to end your current editing session, 

because the editor allows you to edit multiple files simultaneously.) 
___] The second file will appear on the screen. 

2J 2. Use the PUT subcommand to indicate which lines are to be inserted in 

the first file. The PUT subcommand stores lines in a temporary holding 

_J area, starting with the current line, up to an ending, or target, line. Its 

format is as follows: 



====> put target 



3 

~~ where "target" identifies the end of the group of lines to be inserted. It 

~'l is a signal to the editor to stop "putting" lines. 

] A target operand may be specified in various ways, which are described 

in detail in "Chapter 4. Using Targets." A brief description of three 
~~i ways to specify a target follows. They are all equivalent; you can 

choose whichever type you prefer. 

u 

I] 



One way to specify the target is to count the number of lines you want 
~~] to insert, starting with the current line. For example, if a file contains: 



===== a loaf of bread 
===== a jug of wine 

_ ===== thou 

' ~] ===== a portable television 



^J and the line containing "a loaf of bread" is current, the following 

subcommand stores all the above lines: 



====> p UT 4 
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Another way to specify the target is with a character string; the editor 
will "put" all the lines, beginning with the current line, up to, but not 
including, the line containing the string. 

For example, the following subcommand will "put" the first three lines, 
but it will not "put" the line containing "a portable television". 

====> puT/television/ 

A third way to specify a target is the file line number. To display the 
line numbers in the prefix area, you must issue the following 
subcommand: 

====> SET NUMBER ON 

Here's how the above lines might look: 

00010 a loaf of bread 

00011 a jug of wine 

00012 thou 

00013 a portable television 

To specify a target as a line number, type a colon (:) followed by the 
line number. 

The following subcommand puts lines up to, but not including, line 13. 

====> PUT :13 

Enter a QUIT subcommand. The first file reappears on the screen. 

Make sure that the current line is the line after which you want the 
lines from the second file to be inserted. Then enter the following 
subcommand: 






GET 



No operands are required. The lines that were stored by the PUT 
subcommand are inserted; the last line inserted becomes the new 
current line. 

Figure 17 through Figure 20 shows how the PUT and GET subcommands 
are used to insert part of a file into another file: 

The file DESSERT COOKBOOK promises a recipe for cream puffs with 
chocolate sauce. The cream puffs recipe is there, but the chocolate sauce is 
missing. All the sauces are contained in another file called SAUCES 
COOKBOOK. To insert the recipe for chocolate sauce after the recipe for 
cream puffs, first make the desired line current (via /) in the file DESSERT 
COOKBOOK. Since the sauce recipe must follow the cream puffs recipe, 
the current line is the last line of the cream puffs recipe (Figure 17). Then 
enter the following subcommand: 

====> XEDIT SAUCES COOKBOOK 
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This file appears on the screen. The status area (lower right corner) 
indicates that two files are being edited. Move the line pointer to 
the beginning of the lines to be inserted, via UP or /. The beginning 
line contains "CHOCOLATE SAUCE" (Figure 18). Now enter the 
subcommand to store the chocolate sauce recipe: 

==> PUT/VINAIGRETTE/ 

The lines that are stored begin with "CHOCOLATE SAUCE" and 
end with the line preceding "VINAIGRETTE". The PUT 
subcommand could also have been entered as PUT :15 or PUT 7. In 
this screen, line numbers are displayed in the prefix area, which 
means that a SET NUMBER ON subcommand was issued. After the 
PUT subcommand is executed, you can quit this file by entering: 

==> QUIT 

The original file comes back on the screen (Figure 19). Now enter 
the following subcommand to insert the lines that were "put": 



==> GET 

The sauce recipe is inserted, as shown in Figure 20. 
inserted is the new current line. 



DESSERT COOKBOOK Al F 80 Trunc=80 Size=15 Line=8 Col=l Alt=0 



The last line 



I] 

— i 

_j 

3 
3 
II 
3 
3 
3 
3 
3 



■- * * * Top f F ii e * * * 

== CREAM PUFFS WITH CHOCOLATE SAUCE 

2 OUNCES BUTTER 

1/2 TEASPOON SUGAR 

1/2 CUP FLOUR 

1 PINCH OF SALT 
:= 2 EGGS 

2 CUPS HEAVY CREAM, WHIPPED 
I...+....1.. ..+... .2. ...+.. ..3....+. 

== ALMOND COOKIES 

6 TABLESPOONS SOFT BUTTER 
1/2 CUP SUGAR 
2 EGG WHITES 
1 PINCH SALT 
1 CUP ALMONDS, SLICED 
: = * * * End of File * * * 

=> XEDIT SAUCES COOKBOOK 



Figure 17. Inserting Part of a File — Call Out the Second File 



XEDIT 1 File 
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SAUCES 



COOKBOOK Al F 80 Trunc=80 Size=20 Line=8 Col=l Alt=0 



00000 
00001 
00002 
00003 
00004 
00005 
00006 
00007 
00008 

00009 
00010 
00011 
00012 
00013 
00014 
00015 
00016 
00017 



* * * Top of File * * 
APRICOT GLAZE 



JAR APRICOT PRESERVES (1 POUND) 
TABLESPOONS KIRSCH 



CHOCOLATE SAUCE 
| ... + ... .1. .. .+ 



, + . 



+ 



12 OUNCES SEMI-SWEET CHOCOLATE 

2 OUNCES UNSWEETENED CHOCOLATE 

1 CUP HEAVY CREAM 

2 OUNCES COGNAC 

VINAIGRETTE SAUCE 

1/2 CUP OLIVE OIL 
PUT/VINAIGRETTE/ 



X E D I T 2 Files 



Figure 18. Inserting Part of a File — Put Lines to Be Inserted, Then QUIT 



DESSERT COOKBOOK Al F 80 Trunc=80 Size=15 Line=8 Col=l Alt=0 



:= * * * T op of File * * * 

== CREAM PUFFS WITH CHOCOLATE SAUCE 

2 OUNCES BUTTER 

1/2 TEASPOON SUGAR 

1/2 CUP FLOUR 

1 PINCH OF SALT 

2 EGGS 

2 CUPS HEAVY CREAM, WHIPPED 
|. ..+... .1.. ..+... .2. ...+.. ..3... .+ 
== ALMOND COOKIES 

6 TABLESPOONS SOFT BUTTER 
1/2 CUP SUGAR 
2 EGG WHITES 
1 PINCH SALT 
1 CUP ALMONDS, SLICED 
== * * * End of File * * * 

= > GET 



X E D I T 1 File 



Figure 19. Inserting Part of a File - GET 
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J DESSERT COOKBOOK Al F 80 Trunc=80 Size=22 Line=15 Col=l Alt=l 

3 :::=: 



i 



1 PINCH OF SALT 

2 EGGS 
2 CUPS HEAVY CREAM, WHIPPED 

CHOCOLATE SAUCE 



===== 12 OUNCES SEMI-SWEET CHOCOLATE 

J ===== 2 OUNCES UNSWEETENED CHOCOLATE 

===== 1 CUP HEAVY CREAM 

-i ===== 2 OUNCES COGNAC 



3 



|...+....l.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7 

ALMOND COOKIES 



3 



===== 6 TABLESPOONS SOFT BUTTER 

J ===== 1/2 CUP SUGAR 

===== 2 EGG WHITES 

===== 1 PINCH SALT 

===== 1 CUP ALMONDS, SLICED 

===== * * * En d of File * * * 

X E D I T 1 File 
Figure 20. Inserting Part of a File — The Lines Are Inserted 



1 Getting Help 

If you forget how to use a subcommand or would like to see information 
- "| about subcommands not covered in this subset, you can press the PF1 key, 

which is set to the HELP MENU subcommand. 

When the PF1 key is pressed, a list of all subcommands and macros 
~i available with the editor appears on the screen. You then move the cursor 

to the desired subcommand and press ENTER. The subcommand 
~| description appears on the screen, replacing the HELP Menu. Pressing the 

PF3 key returns you to the previous screen and pressing PF4 takes you out 
~n of the HELP display and restores your file on the screen. 



I] 



Learning More About the Editor 



~"| The following is a list of additional XEDIT subcommands and macros that 

are useful in text processing. You can learn how to use them by using the 

~" '] Help facility (described above) or by referring to the publication VM/SP 

System Product Editor Command and Macro Reference. 

I] 

ALL 

] Allows you to collect lines for editing, while excluding others from 

( display. 
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ALTER 

Allows you to change a character to one that is not available on 
your keyboard, like a backspace character. 

COMPRESS, EXPAND 

Allow you to reposition data in new tab columns without retyping 
it. 

LEFT, RIGHT 

Allow you to view columns of data that extend to the left or right of 
the screen display. 

LOWERCAS, UPPERCAS 

Allow you to translate alphabetic characters to all lowercase or all 
uppercase. 

MERGE 

Allows you to combine two sets of lines. 

SET ARBCHAR 

Allows you to specify only the beginning and end of a long string 
that is to be located or changed. 

SET CASE 

Allows you to choose whether data that is typed on the terminal is 
to be entered in the file the same way you type it or translated into 
uppercase. 

SET POINT 

Allows you to assign name(s) to any line; you can reference the 
name(s) in XEDIT subcommands. 

SET SCREEN 

Allows you to view multiple files or multiple views of the same file 
on one screen. 

SET VERIFY 

Allows you to view only specified columns of data, in character or 
hexadecimal or both. 

SORT 

Allows you to arrange the file lines in alphabetical order. 

< (SHIFT LEFT) MACRO 

A prefix macro that allows you to shift left one line or a block of 
lines one or more columns to the left. 

> (SHIFT RIGHT) MACRO 

A prefix macro that allows you to shift right one line or a block of 
lines one or more columns to the right. 
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Summary of XEDIT Subset 



The following table summarizes the subcommands that have been presented 
in this chapter. When a subcommand can be abbreviated, its minimum 
abbreviation is shown in uppercase letters. 



Function 


Subcommand/PF Key 


To create or edit a file 


Xedit 


To enter data 


Input 
POWerinp 


To scroll the screen 


BAckward 

FOrward 

TOP 

Bottom 


To move the line pointer 


Down 

Up 


To move the column pointer 


CLocate 
CFirst 


To make changes to the file 


Change 
CInsert 


To locate data 


CLocate 


To recover deleted data 


RECover 


To set tabs 


SET TABS 
MODify TABS 


To display current tab settings 


Query TABS 


To display line numbers in the 
prefix area 


SET NUMber ON 


To specify whether trailing blanks 
are replaced with nulls to allow 
character insertion 


SET NULls ON 


To end an editing session without 
saving the changes 


QUIT 


To save automatically after 
changing a specified number of 
lines 


SET AUtosave 


To save the changed file when you 
have finished working on it 


FILE 


To store lines to be inserted in 
another file by a subsequent GET 


PUT 


To imbed a complete or a partial 
copy of one file in another 


GET 


To cancel pending prefix 
subcommands 


RESet 



II 
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Function 

Prefix subcommands: 


Subcommand/PF Key 


To add lines 


A 


To delete lines 


D 


To add lines and position cursor for 
indented text 


SI 


To duplicate lines 


■I 


To move lines 


M and F or P 


To copy lines 


C and F or P 


To set the current line 


/ 




PF keys, initial settings: 




To get a Help display 


PF1 


To add a line 


PF2 


To end a session without saving 


PF3 


To use a tab key 


PF4 


To locate and change selectively 


PF5, PF6 


To redisplay a subcommand 


PF6 


To scroll one screen backward 


PF7 


To scroll one screen forward 


PF8 


To repeat previous subcommand 


PF9 


To move the display to the right, 
and move it back when key is 
pressed again 


PF10 


To split or join lines at the cursor 


PF11 


To move the cursor from the screen 
to the command line, or vice versa 


PF12 
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This chapter is designed to give you practice in using some of the XEDIT 
subcommands discussed in Chapter 1. 

The exercise is divided into five parts. You do not have to do all of them at 
one time, but you should do them in sequence. 

Some of the data you will be asked to type contains errors, so that you can 
use subcommands to correct them. 

Remember to press the ENTER key each time you type a subcommand in 
the command line. However, when you press a PF key, do not press the 
ENTER key. 



3 
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Exercise 1. Creating a File 

This part of the exercise covers the following subcommands: SET 
AUTOSAVE, INPUT, QUERY TABS, SET TABS, FILE, and the PF4 key. 

Your first file will contain a list of famous inventions. The filename is 
INVENTOR; the filetype is SCRIPT. 

Type the following command in the CMS command line: 

xedit inventor script 

Now press the ENTER key. The file identification line appears on the first 
line of the screen. The message, Creating new file:, appears on the second 
line (the message line). Take a moment to review the screen layout 
described in Figure 1. Notice that the cursor is positioned on the command 
line, after the large arrow (= = = = >). 

To cause your file to be written to disk at periodic intervals, enter the 
following subcommand: 

====> set autosave 20 

You will enter data in the file using the PF4 key for tabbing. To display 
the editor's initial tab settings for this filetype, enter: 

====> query tabs 

The tab settings for a SCRIPT filetype are displayed in the message line. 
You are going to use different tab settings, so enter: 

====> set tabs 10 30 

Now you're ready to begin entering data. Enter: 

====> input 

The cursor is positioned on the first line of the input zone. Press the PF4 
key, and the cursor moves to the column (10) you specified in the SET 
TABS subcommand. Type: 

Telescope 
Press the PF4 key again. The cursor moves to column 30. Type: 

1608 

Press the PF4 key. The cursor moves to column 10 on the next line of the 
input zone. Type: 

Hot air balloon 
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Press the PF4 key and then type: 



1783 



Using the PF4 key to move the cursor, type the following: 



Margarine 
Tranquilizer 



1869 
1952 



Now press the ENTER key. The status area (lower right corner) shows that 
you are still in input mode. The data you entered has moved up on the 
screen, with the last line you typed becoming the new current line. If you 
had more data to type, you could start typing at the cursor position. For 
now, press the ENTER key to return to edit mode. 

Checkpoint: If you have done everything correctly, your 
screen should look like this: 





* * * Top of File * * * 






Telescope 


1608 




Hot air balloon 


1783 




Margarine 


1869 




Tranquilizer 


1952 


Enter: 






====> 


file 





Exercise 2. Using Power Typing 

This part of the exercise covers the following subcommands: POWERINP, 
TOP, BOTTOM, UP, DOWN, /, the PF11 key, and the PA2 and insert mode 
keys. 

Your second file will contain a description of the invention of the telescope. 
Enter: 

xedit telescop script 

In this file, you will enter the data in power typing mode. Enter: 

power 






In power typing mode, you type continuously, without regard to the length 
of the screen line. If you come to the end of a line and you're in the middle 
of a word, just keep on typing. The cursor will move to the beginning of 
the next line. Two of the words that you type will start on one line and end 
on the next — "accidentally" and "mounted". 
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Now type the following data (with errors): 

One day in 1608 held a lens in each hand and peered through both at once, accide 
ntally discovering that two lenses placed in line would magnify an image. #He mo 
unted lens at each end of a tube and invented the telescope. 

Press the ENTER key twice. You are now in edit mode. 
Checkpoint: Your file should look like this: 



V 



One day in 1608 held a lens in each hand and peered through both at 

once, accidentally discovering that two lenses placed in line would i 

magnify an image. 

He mounted lens at each end of a tube and invented the telescope. r 



The two words that began on one line and finished on the next 
("accidentally" and "mounted") are put back together. The second sentence 
starts on a new line, because you typed a pound sign (#) before it. 
(Remember that a pound sign, the line end character, causes the data that 
follows it to start on a new line.) 

Obviously, the first sentence is missing some words. One way to insert a 
long phrase in a line is to split the line in two. Move the cursor under the 
"h" in "held". Press the PFll key, and the line is split. Now type: 

a Dutch spectacle maker named Lippershey 



In the second sentence, the word "a" is missing before the word "lens". 1. 

Move the cursor under the "1" in "lens". Press the PA2 key, and press the 

insert mode key. Type the word "a" and press the spacebar once. The L 

sentence has moved over to accommodate the added word. Now press the 

RESET key, to take you out of insert mode. [ 



— -y^> Checkpoint: Your file should look like this: l 



r 

One day in 1608 a Dutch spectacle maker named Lippershey I 

held a lens in each hand and peered through both at 

once, accidentally discovering that two lenses placed in line would V 

magnify an image. 

He mounted a lens at each end of a tube and invented the telescope. 

I 

The rest of this exercise will give you practice in moving the line pointer. I. 

If your cursor is not on the command line press PF12 to bring it down to 

the command line and now enter: L 

====> top „ [ 

[ 

r 
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The new current line is the Top of File line. If you wanted to add data at 
the beginning of the file in either input mode or power typing mode, you 
would enter TOP, followed by either INPUT or POWER. 

Enter: 

====> bottom 

The new current line is the last line of the file. Enter: 
====> up 2 

The new current line is two lines up, toward the top of file. 

Enter: 

====> down 2 

The new current line is two lines down, toward the end of file. 

Now type a / (diagonal) in the prefix area of any line, like this: 
====/ or this: ==/== or this: /==== 

When you press the ENTER key, that line becomes the new current line. 

When your file is too big to fit on one screen, you can use the PF7 and PF8 
keys (the BACKWARD and FORWARD subcommands) to scroll the screen. 

Enter the following subcommand to write this file on disk: 
====> file 



I] 



Exercise 3. Using Prefix Subcommands 

This part covers the RECOVER subcommand and the following prefix 
subcommands: a, d, m, and p. 

To create this file, enter: 

xedit balloon script 



Enter: 



====> input 

Type: 

The heat inflated the petticoat and caused it to rise 
The Montgolfier brothers were paper manufacturers. 
Hot air from a fire lifted the first balloon. 

Press the ENTER key twice to reenter edit mode. 
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Let's rearrange these sentences. Type ah "M" in the prefix area of the 
second sentence, and a "P" in the prefix area of the first sentence, like this: 

====p The heat inflated the petticoat and caused it to rise. 
===m= The Montgolfier brothers were paper manufacturers. 

Now press the ENTER key. The sentences have been reversed. 

Type an "a" in the prefix area of the first sentence in the file and press the 
ENTER key. Type the following in the blank line you just added: 

They realized hot air's ability to float a balloon by accident. 



The cursor is at the end of the line you just typed. Without moving the 
cursor, press the PF2 key, which adds a new blank line and moves the 
cursor to the beginning of it. 

Now type: 

Jacques 1 wife washed a petticoat and hung it over a fire to dry, 



Type "5a" in the prefix area of the last line, and press the ENTER key. 
Type in anything you want. Now, type "DD" in both the first and last lines 
you added, like this: 

=dd== This is your first line. 



=dd== This is your fifth line. 

Press the ENTER key. 

Do you really want to keep those lines? If you do, enter: 
====> recover * 

Checkpoint: Your file should look like this: 



^ 



^ 



The Montgolfier brothers were paper manufacturers. 

They realized hot air's ability to float a balloon by accident. 

Jacques' wife washed a petticoat and hung it over a fire to dry 

The heat inflated the petticoat and caused it to rise. 

Hot air from a fire lifted the first balloon. 



Enter: 
====> file 
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Exercise 4. Making Changes 



_] This part of the exercise covers the following subcommands: CHANGE, 

PF5, and PF6 keys for a selective change. 



Enter: 

xedit margarin script 

Enter: 

====> input 

Type these lines: 

Bitter was expensive and in short supply. 

Napoleon sought a substitute for butter that wasn't bitter. 

He needed something like bitter that would store well on ships. 

He held a contest and offered a prize for the best bitter substitute 

Press the ENTER key twice to reenter edit mode. 

Move the line pointer to the first line of the file by entering: 
====> up 3 

Enter: 

====> change/Bitter/Butter/ 

Now you're going to practice using the PF5 and PF6 keys to make a 
selective change. You want to change "bitter" to "butter," but not all of 
the time. 

Type the following subcommand in the command line, but do not press the 
ENTER key. 

====> c/bitter/butter/ 



Now press the PF5 key. The cursor moves under "bitter" in the second 
—J sentence, and the line is highlighted. The message line tells you that if you 

want to make the change, press the PF6 key. This "bitter" is fine, so press 
-J the PF5 key again. 



In the third sentence, you want to make the change, so press the PF6 key. 
The message line tells you that the change has been made. 

Press the PF5 key. 
Press the PF6 key. 
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Checkpoint: Your file should look like this: 



V 



Butter was expensive and in short supply. 

Napoleon sought a substitute for butter that wasn't bitter. 

He needed something like butter that would store well on ships. 

He held a contest and offered a prize for the best butter substitute, 



Enter: 
====> file 

Exercise 5. Getting It All Together 

This part covers the following subcommands: GET and PUT. 

You now have the following files: 

inventor script 
telescop script 
balloon script 
margarin script 

The following exercise will give you practice in transferring data between 
files. Enter: 

xedit inventor script 

You are going to insert the entire file named TELESCOP SCRIPT at the 
end of this file. 

To make the last line of this file current, enter: 
====> bottom 

Now enter: 

====> get telescop 

You do not have to specify a filetype when you GET a file if the filetype of 
the file you are "getting" is the same as the file you're currently editing. 

The message, "EOF reached" tells you that the entire file has been inserted. 
The new current line is the last line that was inserted. The file TELESCOP 
is still on disk; only a copy of it has been inserted. 

Now you're going to insert part of a file into this one. 

Enter: 
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====> xedit balloon 

This file now appears on the screen. Notice that the status area indicates 
that you are editing two files, that is, two files are in virtual storage. 



l You're going to insert lines two and three into the INVENTOR file. Enter: 

====> down 2 



Enter: 

====> put 2 

Enter: 
====> quit 

The INVENTOR file now appears on the screen. Enter: 

====> get 

Lines two and three from the BALLOON file are inserted; the new current 
line is the last line that was inserted. 

Now you're going to insert the entire MARGARIN file. Enter: 
====> get margarin 

The entire file is inserted. 

Checkpoint: Your file should look like this: 



j 

3 
3 

:j 

3 
3 
3 
3 
3 
3 

Telescope 1608 

^J Hot air balloon 1783 

Margarine 1869 

- . Tranquilizer 1952 

j One day in 1608 a Dutch spectacle maker named Lippershey 

held a lens in each hand and peered through both at 

once, accidentally discovering that two lenses placed in line would 
magnify an image. 
He mounted a lens at each end of a tube and invented the telescope. 
"] They realized hot air's ability to float a balloon by accident. 

Jacques' wife washed a petticoat and hung it over a fire to dry. 
-, Butter was expensive and in short supply. 
j Napoleon sought a substitute for butter that wasn't bitter. 

He needed something like butter that would store well on ships. 
"\ He held a contest and offered a prize for the best butter substitute, 



wf 



You have inserted two whole files and one partial file into another file. 
This is a good place to practice prefix subcommands. Using the "A" prefix 
subcommand, add lines between the different inventions, and then type 
headings in those lines. You can also rearrange the inventions by using 
the "M" and "P" (or "F") prefix subcommands. When you are finished, 
enter: 
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====> quit 

A warning message tells you the file has been changed and to enter QQUIT 
if you want to quit anyway. Enter: 

====> qquit 
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Chapter 3. An XEDIT Subset: Text Processing on a Typewriter 
Terminal 



This chapter is written primarily for the person who has limited data 
processing experience; however, some VM/SP CMS experience is assumed. 
For example, you must know how to log on to VM/SP and enter the CMS 
environment. You should also be familiar with the concept of a CMS file. 

When you finish this chapter, you should have a working knowledge of the 
editor. The subcommands presented here comprise a subset of XEDIT 
subcommands, with which you can create a file, enter data, make changes 
to the file, and transfer data between files. The editor has many additional 
capabilities, which are described in the rest of this book and in the 
publication VM/SP System Product Editor Command and Macro Reference. 

This subset has been selected for text processing on a typewriter terminal. 



Editing a File 



XEDIT Command 



j 



To edit a file means to make changes, additions, or deletions to a CMS file 
that is on a disk, and to make these changes interactively: you instruct the 
editor to make a change, the editor makes it, and then you request another 
change. 

You can edit a file that does not exist; when you do so, you are creating a 
file. 



After you log on to VM/SP and enter the CMS environment, you are ready 
to enter the edit environment. 

The editor is invoked with the CMS command XEDIT, whose format is as 
follows: 

XEDIT filename filetype 

If the file already exists on your A-disk, a copy of that file is brought into 
virtual storage; then you can use XEDIT subcommands to make changes or 



ZJ 
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corrections to lines in that file. You enter an XEDIT subcommand by 
typing the subcommand and then pressing the RETURN key. (XEDIT 
subcommands, like CMS commands, can be typed in either uppercase or 
lowercase, or a combination of both.) 



If the file is not found on disk, the editor creates it in virtual storage. 

When a subcommand changes a line, the editor displays, or "verifies," the 
changed line. The editor also communicates with you by displaying error 
or information messages. For purposes of illustration in this chapter, 
anything displayed by the editor is enclosed in a box. Subcommands or 
data that you would enter are not. 

Now let's create a simple file. Its filename and filetype will be POEM1 
SCRIPT. The following command is entered to begin creating the file: 

XEDIT POEM1 SCRIPT 

Because the file is new, the editor responds with the following messages: 

Creating new file: 
XEDIT: 



Entering Data 



INPUT Subcommand 



The following subcommands are discussed in this section: 

INPUT 
QUERY LRECL 



After you enter the XEDIT command, you are in edit mode. You must be in 
edit mode to enter XEDIT subcommands. 



However, to enter data in the file, you must be in input mode. Type the 
following subcommand and press the RETURN key to enter input mode: 

INPUT 

The editor displays the following message: 



Input mode: 



You can then type in the data. Each line that you enter while in input 
mode is considered to be a data line and will be written in the file. To end 
a line, press the RETURN key; the line will then be inserted into the copy 
of the file in virtual storage. 
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No line may be longer than the logical record length of the file, which 
H varies according to filetype. To find out the logical record length of any 

file, you can enter the following subcommand (in edit mode): 

3 
3 
3 
3 

3 



QUERY LRECL 

In the examples used here, the filetype is SCRIPT, which has a logical 
record length of 132. If you type more than 132 characters in a line before 
pressing the RETURN key, the editor truncates the extra characters. 

Now let's start typing lines to be entered in the file: 



"THE OCTOPUS," by Ogden Nash 
Tell me, Octopus, I begs, 
_] Is those things arms, or is they legs? 

I marvel at thee, Octopus; 
If I were thou, I'd call me Us. 



When you are finished typing data and want to return to edit mode (either 
to make changes to the file or to end the editing session), press the 
RETURN key on a null line. 

The editor comes back with 



XEDIT: 



~1 During an editing session, you can enter input mode at any time to insert 

new lines of data in the file. After the INPUT subcommand is entered, the 

""] editor inserts the lines you type after the current line. In this example, 

since the file is new, the lines are inserted at the beginning of the file. 

H Later, you will see how to make any line the current line, so that you can 

insert lines between any two existing lines in a file. 

3 

This is how the data looks in the file. The following two subcommands, 
"] which will be discussed later, are used to display the data that was entered 

in input mode: 

3 
□ 

D 

3 
■J 

3 



TOP 




TYPE * 
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TOF: 

^THE OCTOPUS/* by Ogden Nash 

Tell me, Octopus, I begs, 

Is those things arms, or is they legs? 

J. marvel at thee, Octopus; 

If I were thou, I'd call me Us. 

EOF: 



Column Pointer 



Notice that the first letter in each line is underscored. Underscores will 
only show on terminals that allow underscoring (like a 2741). This 
underscore character (_) is not contained in the file, and it will not appear 
on a printed copy of the file. It represents the column pointer. 

Various subcommands perform their editing functions within a line starting 
at the column pointer, which you can move to different column positions by 
using XEDIT subcommands that will be discussed later. The column under 
which the column pointer is positioned is called the current column. In the 
example above, the current column is column one. 



Moving through a File 



The following subcommands are discussed in this section: 

TYPE 

UP 

DOWN 

TOP 

BOTTOM 

When you use the XEDIT command to create a new file, the file is created 
in virtual storage. When the XEDIT command is used to call out an 
existing file, a copy is brought into virtual storage. In either case, you can 
picture the file as a series of records, or lines; these lines are available for 
you to change or delete. You can also insert new lines following any line 
that is already in the file. 



Line Pointer 



The line that you are currently editing is called the current line. 



Naturally, the line that is current changes as you move up and down in the 
file to edit various lines. When the line that is current changes, we say 
that the line pointer has moved. Many XEDIT subcommands perform their 
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What you do during an editing session is: 

o Position the line pointer at the line you want to edit. 



l] 

'J 

~1 
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functions starting with the current line and move the line pointer when 
H they are finished. 

H You can change which line is current, that is, you can move the line 

pointer, by using the subcommands discussed in this section. 

3 
3 
3 

o Edit the line (change characters in it, delete it, or insert new lines 
2J following it). 

1] o Position the line pointer at the next line you want to edit. 

TYPE Subcommand 

Many XEDIT subcommands operate either on, or starting with, the current 
~i line. For example, the INPUT subcommand inserts new lines of data after 

the current line. Therefore, you often need to determine which line is 
~ | current so that you can move the line pointer, if necessary. 

~i To display the current line, enter the TYPE subcommand, whose format is: 

TYPE 

To display more than one line, enter the TYPE subcommand with the 
number of lines you want to see. For example, the following subcommand 
displays 5 lines, beginning with the current line: 

TYPE 5 



TOP 

(moves the line pointer to the top of the file and displays "TOF:") 

TYPE * 

(displays all the lines in the file) 



To display the entire file, you must first position the line pointer at the top 
_J of the file. The following subcommands move the line pointer to the top of 

the file and then display the entire file: 

:j 

3 

3 

After the TYPE subcommand is executed, the line pointer is positioned at 
~n the last line that was displayed. For example, if you type the entire file, the 

null "EOF" line will become the new current line. Of course, if you type 
— l only one (the current) line, the line pointer will not move. 

3 ■ 

1 
— ' Chapter 3. An XEDIT Subset: Text Processing on a Typewriter Terminal DO 
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UP and DOWN Subcommands 

You can move the line pointer up or down one or more lines. 

The UP subcommand moves the line pointer toward the beginning of the 
file and displays the new current line. Its format is: 

UP n 

where "n" is the number of lines you want to move the line pointer. If 
the number is omitted, "1" is assumed. 

The DOWN subcommand moves the line pointer toward the end of the file 
and displays the new current line. Its format is: 

DOWN n 

where "n" is the number of lines you want to move the line pointer. If 
the number is omitted, "1" is assumed. 

Let's look at the poem file again: 

TOP 



(move the line pointer to the top of the file) 



TOF: 



TYPE * 

(display the whole file) 



TOF: 












"THE 


OCTOPUS," by 


Ogden Nash 




Tell 


me, 


Octopus, I begs, 






Is those 


things arms, or is 


they 


legs? 


I marvel 


at thee, 


Octopus; 






If I 


were thou, I 


d call me 


Us. 




EOF: 













The TYPE * subcommand was used to display the entire file; since the last 
line displayed by a TYPE subcommand is the new current line, the "EOF" 
line is now the current line. 

The following subcommands show how the UP and DOWN subcommands 
are used to move the line pointer up and down in the file. Each time the 
line pointer is moved, the editor displays the new current line. 
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UP 2 



(move the line pointer up two lines from the EOF line) 



I marvel at thee, Octopus; 



DOWN 

(move the line pointer down one line) 



If I were thou, I'd call me Us 



To insert new lines of data after any existing file line, you can do the 
following: 

• Issue the UP or DOWN subcommand to move the line pointer to the 
line after which you want the data to be inserted. 

• Then enter the INPUT subcommand. 
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3 
3 
3 
3 
3 
3 
3 
□ 
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TOP and BOTTOM Subcommands 

You can also move the line pointer to the the beginning or end of the file. 

To move the line pointer to the null "TOF" line that precedes the first line 
of the file, issue the following subcommand: 

TOP 

To move the line pointer to the last file line, issue the following 
subcommand: 

BOTTOM 

To begin entering new lines either at the beginning or the end of a file, you 
can use the following sequence of subcommands: 

TOP (or BOTTOM) 

INPUT 

Then you enter new data lines. 
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Making Changes in a File 



The following subcommands are discussed in this section: 

CLOCATE 

CFIRST 

CINSERT 

CDELETE 

CAPPEND 

CHANGE 

Often, you need to insert or delete characters in a line or change one word 
to another. The subcommands discussed in this section enable you to 
insert, delete, or change characters based on the position of the column 
pointer, which is represented as an underscore character (_) when a line is 
displayed. 



CLOCATE Subcommand 



The CLOCATE subcommand is used to move the column pointer to the 
column where you want to insert, delete, or change characters. 

The CLOCATE subcommand searches a file, beginning with the current line, 
for a character string that you specify. Its format is as follows: 

CLOCATE/string/ 



The character string should be enclosed in delimiters. The diagonal (/) is 

the delimiter used in these examples, but it may be any character (except i. 

for a plus ( + ), minus (-), not ( — i), or period (.)) that does not also appear in 

the character string (for example, CLOCATE?VM/CMS?). I 

If the string is found, two things happen: the line that contains the string !■ 

becomes the new current line (and is displayed); and the column pointer 

moves under the first character of the string. L 

For example, in the file shown above, the subcommands: L 

TOP [ 

(move the line pointer to the top of the file) [~ 

CLOCATE/legs/ T 

(locate the string) f 

cause the following line to be displayed: [" 
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Is those things arms, or is they jLegs? 



Notice that the line pointer moved to the line containing the string "legs,' 
and the column pointer moved under the first character of the string. 



CFIRST Subcommand 



After using subcommands that move the column pointer, it's a good idea to 
reset the column pointer to the beginning of the line. The following 
subcommand moves the column pointer to the beginning of the line: 

CFIRST 

For example, in the line shown above, where the column pointer is under 
the "1" in "legs," issuing a CFIRST subcommmand results in: 



Is those things arms, or is they legs? 



CINSERT Subcommand 



The CINSERT subcommand is used to insert characters immediately before 
the column pointer. 

For example, a file contains the following line: 



Mt . Everest is high, 



Note the position of the column pointer, in column one. To insert the 
phrase "exactly 29,000 feet" before the word "high," first move the column 
pointer to the first character in "high," by using the following 
subcommand: 

CLOCATE/high/ 

The editor moves the column pointer and displays the line: 



Mt . Everest is high 



Now you can insert the phrase: 

CINSERT exactly 29,000 feet 
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The editor inserts whatever you type in the operand of the CINSERT 
subcommand. In the subcommand above, the spacebar was pressed once 
after the word "feet" so that a blank would separate "feet" and "high". 

The resulting line is displayed: 



Mt . Everest is exactly 29,000 feet high, 



Let's look at another example. The CLOCATE subcommand is used to 
move the column pointer; then the CINSERT subcommand is used to insert 
characters immediately before the column pointer position. 

A file contains the following line: 



Xf anything can go, it will. 



CLOCATE/,/ 

(move the column pointer) 



If anything can goj. it will 



CINSERT wrong 

(insert "wrong" before the column pointer) 



If anything can go_wrong, it will. 



(In the CINSERT subcommand above, note that there are two spaces 
between "CINSERT" and "wrong": one is the required space between the 
subcommand name and the operand; one is the blank space needed between 
"go" and "wrong".) 

If only one blank space were used, the result would be the following: 



If anything can gowrong, it will 



The editor allows you to insert blanks with the CINSERT subcommand — 
simply type the required number of blanks (by pressing the spacebar) in the 
operand. For example: 
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If anything can gowrong, it will. 



CINSERT 



(Press the spacebar twice: once to separate the subcommand name and 
operand; once for the operand.) 



If anything can go_wrong, it will. 



CDELETE Subcommand 



The CDELETE subcommand is used to delete one or more characters from 
the current line, starting at the column pointer. 

A file contains the following line: 



To be or not to be or not to be - that is the question. 



The line contains one too many "or not to be". Since deletion starts at the 
column pointer, first move the column pointer with the following 
subcommand: 

CLOCATE/or/ 



To be or not to be or not to be - that is the question, 



Then, you can use the CDELETE subcommand to specify the number of 
characters to be deleted. Count the number of characters to be deleted, 
starting with the current column: 

CDELETE 13 

The resulting line looks like this: 



To be or not to be - that is the question 



The CDELETE subcommand issued above specified a "13" as the operand; it 
means, "delete 13 characters, starting at the column pointer." 
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If you did not want to count the number of characters, you could have 
specified the operand of the CDELETE subcommand as a character string. 
For example: 

CDELETE/or/ 

When this form of the CDELETE subcommand is used, it means, "delete 
characters from the column pointer to the first character of the string 
specified in the operand." The result would be the same as the line shown 
above; the extra "or not to be" would be removed. 

In summary, the CDELETE subcommand removes characters from a line, 
from the column pointer to the column position specified in the operand. 
The operand may be specified as the number of characters to be removed, or 
it may be specified as a character string. After the CDELETE subcommand 
is executed, the editor displays the changed line. 



CAPPEND Subcommand 



Use the CAPPEND subcommand to append words to the end of the current 
line. 

The format of the CAPPEND subcommand is: 

CAPPEND text 

where "text" represents the data you want to add to the end of the line. 
For example, a file contains the following line: 



It is an ancient mariner, 



However, the line should read: 

It is an ancient mariner, and he stoppeth one of three. 

The following subcommand adds the desired text: 

CAPPEND and he stoppeth one of three. 

(Two blanks separate the subcommand name and the operand.) 
The resulting line looks like this: 



It is an ancient mariner ,_and he stoppeth one of three 
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Notice that the column pointer has moved to the first character of the 
"I appended text, which was a blank. 
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CHANGE Subcommand 



Changing One Word to Another 



CHANGE/oldword/newword/ 

For example, the current line in a file contains the following: 



- | Replacing one word with another is the simplest type of change. Use the 

following form of the CHANGE subcommand to change the first occurrence 
- 1 of a word in the current line: 

3 
3 
3 
3 

CHANGE/rose/daisy/ 
_, The resulting line looks like this: 



A rose is a rose is a rose 



A daisy is a rose is a rose, 



3 
3 
3 
3 
3 
3 
3 

If you want to make a global change, that is, change every occurrence of a 
~ i word, first move the line pointer to the line where you want the change to 



Note that the editor automatically makes room in the line for "daisy," even 
though it is longer than "rose". Conversely, a word can be replaced by a 
shorter word; the editor removes extra blanks. 

You can use the CLOCATE and CHANGE subcommands to locate and 
change any string in a file. If the line containing the string is the current 
line, you don't have to use a CLOCATE subcommand; the CHANGE 
subcommand both locates the string and changes it. 



Making a Global Change 



begin, and use the following form: 

CHANGE/oldword/newword/ * * 

In the following example, the word "rose" is changed to "daisy" every time 
it appears. (The line pointer is already positioned at the first line shown.) 
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A rose 


is 


a rose 


is 


a rose. 


A rose 


is 


a rose 


is 


a rose. 


A rose 


is 


a rose 


is 


a rose. 


A rose 


is 


a rose 


is 


a rose. 



CHANGE/rose/daisy/ * * 

produces the following changes in the file (the editor displays only those 
lines that have been changed): 



A 


daisy 


is 


a 


daisy 


is 


a 


daisy. 


A 


daisy 


is 


a 


daisy 


xs 


a 


daisy. 


A 


daisy 


is 


a 


daisy 


is 


a 


daisy. 


A 


daisy 


is 


a 


daisy 


is 


a 


daisy. 



Another variation of the CHANGE subcommand can be used when you 
want to change a word throughout the file, but you want to change only the 
first occurrence in each line: 



CHANGE/oldword/newword/ 



Making a Selective Change 



Suppose that you want to change one word to another only some of the 
time. You can use repeated executions of the CLOCATE subcommand to 
scan the file, issuing a CHANGE subcommand only when you want to make 
the change. 

Instead of typing the same CLOCATE subcommand over and over, you can 
use the = subcommand, which repeats the last subcommand you entered. 
Using the = subcommand saves you the time it takes to retype the 
subcommand. To enter the = subcommand, simply type an equal sign ( = ) 
and press the RETURN key. 



Inserting and Deleting Lines 



The following subcommands are discussed in this section: 

INPUT line 
DELETE 
RECOVER 
REPLACE 
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Inserting a Line 



You can insert a single line of data between existing lines by using the 
INPUT subcommand followed by the line of data you want inserted. One 
blank must separate the subcommand name and the data line. 

For example: 

INPUT this is the line I want to insert 

inserts a single line following the current line, without leaving edit mode. 
(If you want to insert more than one line, you would issue the INPUT 
subcommand with no operand to enter input mode.) 

To insert a blank line in the file, enter the INPUT subcommand and press 
the spacebar at least twice before pressing the RETURN key. A blank line 
will be inserted after the current line. 

For example, if a file contains the following lines: 



TOF: 

Some primal termite knocked on wood 
And tasted it, and found it good, 
And that is why your Cousin May, 
Fell through the parlor floor today. 



The current line is the last line displayed above. To insert a title line, issue 
the following subcommand: 

INPUT "The Termite," by Ogden Nash 

Now the file looks like this (TOP and TYPE 6 are used to display the whole 
file): 



TOF: 








Some 


primal 


termite knocked 


on wood 


And 


tasted i 


t, and found it 


good, 


And 


that is 


why your Cousin 


May, 


Fell 


through 


the parlor floor today. 


"The 


Termite 


, " by Ogden Nash 



To insert a blank line between the poem and the title line, you could issue 
the following subcommands: 

UP 

(move the line pointer up one line) 
INPUT 

(press the spacebar twice before pressing the RETURN key) 
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Now the file looks like this: 



Deleting Lines 



TOF: 








Some 


primal termite knocked 


on wood 


And 


tasted it, and found it 


good, 


And 


that is why your Cousin 


May, 


Fell 


through the parlor 


floor today. 


^The 


Termite," by Ogden 


Nash 



Use the DELETE subcommand to delete one or more lines from a file, 
beginning with the current line. 

To delete only the current line, use the form: 

DELETE 

To delete more than one line, specify the number of lines in the operand: 

DELETE 5 

deletes five lines, including the current line. 

To delete the rest of the file, use the form: 

DELETE * 

If you want to delete a number of lines, and you don't want to bother 
counting how many, you can use the form: 

DELETE/string/ 

Lines will be deleted, starting with the current line, up to (but not 
including) the line containing the specified string. 

For example, if a file contains the following lines, and the first line shown 
is the current line: 



a portable television 

a transistor radio 

a frisbee 

a loaf of bread 

a jug of wine 

thou 



The following subcommand: 

DELETE/bread/ 
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deletes all lines from the current line up to, but not including, the line 
containing "bread". Therefore, all that's left is: 



a loaf of bread 
a jug of wine 
thou 



Lost and Found Department 



Replacing a Line 



If you delete one or more lines and change your mind, all is not lost. You 
can recover the lines at any time during an editing session with the 
RECOVER subcommand. 

The following subcommand returns lines deleted in an editing session: 

RECOVER n 

where n represents the number of lines you wish to recover. 

The last lines that were deleted are the first lines to be recovered. For 
instance, in our previous example of deleting lines, if you entered: 

RECOVER 2 

you would get the radio and frisbee back: 



a transistor radio 

a frisbee 

a loaf of bread 

a jug of wine 

thou 



The recovered lines are inserted starting at the current line. If the lines 
were deleted from different places in the file, you have to put them back 
where they belong by using the MOVE subcommand, discussed below. 

If you want to recover all lines that have been deleted during an editing 
session, use the form: 

RECOVER * 



You've seen how to insert a new line and delete a line, using INPUT line 
and DELETE. The REPLACE subcommand does both; it deletes the 
current line and replaces it with the text you specify. 

The format of the REPLACE subcommand is: 
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REPLACE text 

However, if you enter the REPLACE subcommand with no text, the editor 
deletes the current line and automatically places you in input mode. 



Moving and Copying Lines 

The following subcommands are discussed in this section: [ 

MOVE [" 

COPY 

r 

MOVE Subcommand [ 

Suppose you want to remove some lines from their current location and r 

insert them in another part of the file. You can use the MOVE 

subcommand to move one or more lines, beginning with the current line, to [ 

a different location in the file. The format of the MOVE subcommand is as 

follows: Q 



To eliminate the need for counting lines, you can specify the "to" operand 
as a character string. The editor searches the file for a line that contains 
the string and moves the "from" line(s) after that line. 



MOVE from to r- 

The first operand represents the number of lines to be moved, starting with p 

the current line. The second operand represents the destination; the line(s) 

is inserted after the destination line and is deleted from its original r 

location. 

r 
For example, to move the current line three lines down in the file, you can L 

use the following subcommand: r- 

MOVE 1 3 

r 

L. 
To move the current line and the two lines following it three lines down in 
the file, you can use the following subcommand: I 

MOVE 3 3 [ 

To move a line backward in the file, you can specify a minus ( — ) sign in [ 

front of the "to" operand. For example: 

MOVE 1 -3 

moves the current line up two lines in the file. Remember, the "to" operand 
represents the line after which a line is to be moved; therefore, if the r 

destination is — 3, the line is inserted after that line, or two lines up. 
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For example: 

MOVE 1 /string/ 

moves the current line after the line containing the string. 

Similarly, you can move a line backward in the file by specifying a minus 
( — ) sign before the string. For example: 

MOVE 1 -/string/ 

moves the current line backward in the file after the line that contains the 
string. 



Let's look at an example: 



filberts 

almonds 

cashews 

chestnuts 

pecans 

walnuts 



The following subcommands would each move the line containing "filberts" 
(the current line) after the line containing "chestnuts". 

MOVE 1 3 or MOVE 1 /chestnuts/ 



almonds 

cashews 

chestnuts 

filberts 

pecans 

walnuts 



COPY Subcommand 



3 






3] 



The procedure for copying lines is the same as for moving lines. The COPY 
subcommand leaves the original line(s) in place and makes a duplicate at 
the indicated destination. 

The format of the COPY subcommand is: 

COPY from to 

One or more lines, beginning with the current line, are copied after the 
destination line. 



Chapter 3. An XEDIT Subset: Text Processing on a Typewriter Terminal 79 



r~i 




LPREFIX Subcommand 



You can use the LPREFIX subcommand to simulate writing in the prefix 
area of the current line, even though the prefix area is not available on a 
typewriter terminal. LPREFIX can be used to perform some of the 
functions (for example, moving or copying lines) provided by prefix 
subcommands and macros on display terminals. 

For a description of the LPREFIX subcommand, see the VM/SP System 
Product Editor Command and Macro Reference. 



Ending an Editing Session 



FILE Subcommand 



QUIT Subcommand 



The following subcommands are discussed in this section: 

FILE 
QUIT 
SET AUTOSAVE 



When you use the XEDIT command to create a new file, the file is created 
in virtual storage. When you make changes to an existing file, those 
changes are made to a copy of the file that is brought into virtual storage 
(when the XEDIT command is entered). However, virtual storage is 
temporary. To write a new or modified file on disk, which is permanent 
storage, you must enter the following subcommand: 

FILE 

When the FILE subcommand is executed, the file is written on disk and 
control is returned to CMS. 



Use the QUIT subcommand to end an editing session and leave the 
permanent copy of the file intact on the disk. If the file is new, it is not 
written on disk. 

The format of the QUIT subcommand is as follows: 

QUIT 

You would use the QUIT subcommand instead of the FILE subcommand 
when you edit a file merely to examine, but not to change, its contents, or if 
you discover you have made errors in changing a file and do not want them 
to be recorded. 
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When a file is new or has been changed, the editor gives you a warning 
--■) message to prevent the inadvertent use of a QUIT instead of a FILE. The 

message is as follows: 

1 



--\ File has been changed. Use QQUIT to quit anyway, 

If you really don't want to save the file, enter "QQUIT" (abbreviated as 
"J "QQ"). If you wish to save the changes, enter "FILE". 

J SET AUTOSAVE Subcommand 

3 



3 



3 



Files on disk are not affected if the system malfunctions, or "goes down." 
However, a new file that you're creating or the changes you're making to 
an existing file might be lost if the system fails. You can minimize this 
danger by using the SET AUTOSAVE subcommand, whose format is as 
follows: 

SET AUTOSAVE n 



J The SET AUTOSAVE subcommand causes your file to be written to disk 

automatically, after you've typed in or changed a certain number of lines. 

3 You specify what. that number will be with the "n" operand of the SET 

AUTOSAVE subcommand. If you want the file written to disk, or "saved," 

—J every time you've changed ten lines, enter the following subcommand: 

'_] SET AUTOSAVE 10 

^J The SET AUTOSAVE subcommand can be issued at any time during an 

editing session. It's a good idea, however, to issue the subcommand right 

2J after you issue an XEDIT command to create a new file or to call an 

existing file from disk. 

"J 

When a file is saved on disk by AUTOSAVE, it is written into a new file. 
~J The filename of this file is a number and its filetype is "AUTOSAVE." If 

the system goes down while you're editing a file, you can change the fileid 
3 back to its original filename and filetype by issuing the CMS command 

ERASE to erase the original file and then by issuing the CMS command 
3 RENAME. 

3 For example, if your AUTOSAVE file is labeled "100001 AUTOSAVE Al" 

and the original file is "POEM1 SCRIPT Al", use the following CMS 
3 commands to rename it: 

^] ERASE POEM1 SCRIPT 

RENAME 100001 AUTOSAVE Al POEM1 SCRIPT Al 

J 



Then you'll be back in business and can use the XEDIT command to start 
editing the file again. 
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If you issue a SET AUTOSAVE subcommand while you're creating a new 
file, and then issue a QUIT subcommand, the file is not saved. However, 
the AUTOSAVE file is still available on disk. If you issue a SET 
AUTOSAVE subcommand while you're revising an existing file and then 
you issue a QUIT subcommand, no revisions are saved. However, the 
AUTOSAVE file is still available on disk. 



Inserting Data from Another File 



To insert all or part of one file into another, you can use the GET 
subcommand. The chapters in this book were created as separate files and 
then combined into one file by using the GET subcommand. (A file that 
you "get" is not destroyed; a copy of that file is inserted.) 

The GET subcommand inserts a file after the current line. Therefore, you 
must move the line pointer to the line after which you want to insert a file. 
If you want to insert another file at the end of your file, you can use the 
BOTTOM subcommand to make the last line current. If you want to insert 
another file somewhere in the middle of your file, you can use the UP or 
DOWN subcommands to make the desired line current. 



L". 



Inserting a Whole File 



Suppose you were writing a book of poetry, and you created a separate file 
for each poem. To combine two of the poems into one file, you would use 
the following form of the GET subcommand: 

GET filename filetype 

When the entire second file has been inserted, the editor displays the 
following message: 



EOF Reached. 



For example, if you were editing a file called POEM1 SCRIPT and wanted 
to insert another file called POEM2 SCRIPT, you would enter the following 
subcommands: 



BOTTOM 

(move the line pointer to the end of the file) 

GET POEM2 SCRIPT 



(insert the whole file) 
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Inserting Part of Another File 

To insert part of another file, you can specify in the GET subcommand the 
J line number of the first line and the number of lines you want to insert. 

The following GET subcommand inserts the first ten lines of a second file: 

GET FILE2 DATA 1 10 

3 

If you don't know the line numbers, you can: call out a second file without 
"] ending your current editing session; put the lines you want to insert into a 

temporary file; and insert them into your current file. 

J 

This might sound complicated, but all you need to learn is one more 
^J subcommand — PUT. 

_] First, let's identify the steps you would take to insert part of another file 

and then illustrate them with an example. 

-J 

1. While editing the first file, enter an XEDIT subcommand to call out the 
2J second file. You do not have to end your current editing session, 

because the editor allows you to edit multiple files simultaneously. 

3 

2. Use the PUT subcommand to indicate which lines are to be inserted in 
_J the first file. The PUT subcommand stores lines in a temporary holding 

area, starting with the current line, up to an ending, or target, line. Its 
_] format is as follows: 

- ] PUT target 

- "| where "target" identifies the end of a group of lines to be inserted. It is 

~ a signal to the editor to stop "putting" lines. 

1! 

A target operand may be specified in various ways, which are described 
"■ 1 in detail in "Chapter 4: Using Targets." A brief description of two 

ways to specify a target follows. They are equivalent; you can choose 
'" | whichever type you prefer. 

~ 1 One way to specify the target is to count the number of lines you want 

to insert, starting with the current line. For example, if a file contains: 



3) 



a loaf of bread 

a jug of wine 

thou 

a portable television 

and the line containing "a loaf of bread" is current, the following 
subcommand stores all the above lines: 

PUT 4 

Another way to specify the target is with a character string; the editor 
will "put" all the lines, beginning with the current line, up to, but not 
including, the line containing the string. 
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For example, the following subcommand will "put" the first three lines, 
but it will not "put" the line containing "a portable television". 

PUT/television/ 

3. Enter a QUIT subcommand to return to your original file. 

4. Make sure that the current line is the line after which you want to 
insert lines from the second file. Then enter the following subcommand: 

GET 

No operands are required. The lines that were stored by the PUT 
subcommand are inserted; the last line inserted becomes the new 
current line. 

The following example illustrates how the PUT and GET subcommands are 
used to insert part of a file into another file: 

A file, DESSERT COOKBOOK, is being compiled. It contains many 
recipes, among which is a recipe for cream puffs with chocolate sauce. The 
author of the cookbook keeps a separate file, called SAUCES COOKBOOK, 
which contains recipes for sauces. Whenever a recipe requires an 
accompanying sauce, the author can select a sauce recipe from the second 
file and insert it in the first. In this example, the recipe for chocolate sauce 
will be inserted after the recipe for cream puffs. 

XEDIT DESSERT COOKBOOK 

(Call out the first file.) 
CLOCATE/CREAM PUFFS/ 

(Locate the recipe.) 

TYPE 10 

(Display the recipe. You could have displayed the whole file by using 
TYPE *, but it's not necessary.) 



CREAM PUFFS WITH CHOCOLATE SAUCE 

Z 2 OUNCES BUTTER 

_ 1/2 TEASPOON SUGAR 

_ 1/2 CUP FLOUR 

_ 1 PINCH OF SALT 

2 EGGS 

_ 2 CUPS HEAVY CREAM, WHIPPED 

ALMOND COOKIES 
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UP 1 



(Move the line pointer to the line after which you want to insert the 
sauce recipe. The editor displays the new current line, which is the 
blank line between "HEAVY CREAM" and "ALMOND COOKIES".) 



XEDIT SAUCES COOKBOOK 
(Edit the second file.) 

CLOCATE/CHOCOLATE SAUCE/ 
(Locate the sauce recipe.) 

TYPE 10 

(Display 10 lines.) 



CHOCOLATE 


SAUCE 






12 
2 
1 
2 




OUNCES SEMI-SWEET 
OUNCES UNSWEETENED 
CUP HEAVY CREAM 
OUNCES COGNAC 


CHOCOLATE 
CHOCOLATE 


VINAIGRETTE SAUCE 






I 1/2 


CUP OLIVE 


OIL 





UP 10 

(Move the line pointer to the beginning of the recipe) 

PUT/VINAIGRETTE/ 

Lines are stored, beginning with the line containing "CHOCOLATE 
SAUCE" and ending with the line preceding the one containing 
"VINAIGRETTE". The PUT subcommand could also be entered as PUT 7. 

QUIT 

The original file is now being edited. 

GET 

The sauce recipe is inserted. 
The resulting file looks like this: 
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CREAM PUFFS WITH CHOCOLATE SAUCE 

Z 2 OUNCES BUTTER 

1/2 TEASPOON SUGAR 

1/2 CUP FLOUR 

_ 1 PINCH OF SALT 

2 EGGS 

2 CUPS HEAVY CREAM, WHIPPED 

CHOCOLATE SAUCE 

Z 12 OUNCES SEMI-SWEET CHOCOLATE 

_ 2 OUNCES UNSWEETENED CHOCOLATE 

1 CUP HEAVY CREAM 

2 OUNCES COGNAC 

ALMOND COOKIES 



Using Special Characters 



Tab Characters 



The following subcommands are discussed in this section: 

SET IMAGE 
SET TABS 
QUERY TABS 

The SET IMAGE subcommand controls how special characters, once 
entered on an input line, are going to be represented in a file. The special 
characters affected by the SET IMAGE subcommand are: 

• Tab characters (X'05') 

• Backspace characters (X'16'). 

The format of the SET IMAGE subcommand is: 

SET IMAGE ON 
OFF 
CANON 



The important thing to remember about tab settings is that there are two 
kinds: physical and logical. 

Physical tab settings are set manually on the typewriter; each time you 
press the TAB key, the type ball moves to the column you set up as the 
physical tab stop. 
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Setting Tabs 



Logical tab settings indicate the column positions where fields within a 
record begin. They are defined by the SET TABS subcommand, whose 
format is: 

SET TABS nl n2 n3 ... 

where nl... represents the column numbers for the logical tab settings. 

These logical tab settings do not necessarily correspond to the physical tab 
settings. 

How the data is entered in the file when you press the TAB key depends on 
whether the SET IMAGE subcommand has been issued with ON or OFF as 
the operand. (SET IMAGE ON is the initial setting for all filetypes except 
SCRIPT, MACLIB, MODULE, and TEXT.) 

If SET IMAGE ON is in effect when you press the TAB key, the logical tab 
settings determine how the data will be entered in the file. The editor 
replaces the tab characters with an appropriate number of blanks, starting 
at the column where you pressed the TAB key, and ending at the last 
column before the next logical tab setting. The next character entered after 
the tab becomes the first character of the next field. 

For example, if you enter: 

SET TABS 1 15 

and then enter a line that begins with a tab character, the first data 
character following the tab is written into the file in column 15, regardless 
of the physical tab stop on the terminal. 

If SET IMAGE OFF is in effect, a tab character is inserted in the record, 
just as any other data character is inserted. No blanks are inserted. 

If you want to insert a tab character (X'05') into a record and SET IMAGE 
ON is in effect, you can issue a SET IMAGE OFF subcommand before 
entering the line, and then use the TAB key as a character key. Pressing 
the TAB key causes a tab character to be inserted in a line. 



When you create a file, default logical tab settings are in effect; therefore, 
you do not need to set them. To determine the default tab settings for a 
particular filetype, you can use the following subcommand: 

QUERY TABS 

If you want to change the default tab settings, you can use the SET TABS 
subcommand. Then, regardless of what physical tab stops have been set up 
on your terminal, when you press the TAB key with SET IMAGE ON in 
effect, the data you enter is spaced to the columns you defined. 
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Note: When the INPUT subcommand is used to enter one line, and SET 
IMAGE ON is in effect, the specified line is placed in the file starting in the 
first tab column defined by the SET TABS subcommand. For example, if 
you enter: 

SET TABS 5 10 15 20 

and then enter an input line: 

INPUT This is the input line 

columns 1, 2, 3, and 4 contain blanks; the text begins in column 5. 

Therefore, make sure that the first number specified in the SET TABS 
subcommand is the column in which you want the data to begin. 



Backspace Characters 



If you use backspaces and underscores in your file, you should issue SET 
IMAGE OFF or SET IMAGE CANON. SET IMAGE CANON is the initial 
setting for SCRIPT files. 

SET IMAGE OFF means that backspace characters (as well as tab 
characters) are left as they are entered. 

SET IMAGE CANON means that regardless of how the characters are 
typed in (characters, backspaces, underscores), the editor orders the 
characters in the file as: character — backspace — underscore, character — 
backspace — underscore, and so forth. If, for example, you want an input 
line to look like this: 

ABC 

You could enter it as: 

ABC, 3 backspaces, 3 underscores 

- or - 
3 underscores, 3 backspaces, ABC 

A typewriter types out the line in the following order: 

A, backspace, underscore 

B, backspace, underscore 

C, backspace, underscore 

which results in: 

ABC 

If you need to modify a line that has backspaces, and you do not want to 
rekey all of the characters, you can use the ALTER subcommand to alter 
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all of the backspaces to some other character. The following sequence 
shows how you can delete all of the backspace characters in a line: 

AAAAA 

ALTER 16 + 1 * 

(alter all X'16's to + 's in this line) 

_+A_+A_+A_+A_+A 
CHANGE/_+// 1 * 

(change all occurrences of " _ + " to null in this line) 

AAAAA 



Summary of XEDIT Subset 
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This table summarizes the subcommands that have been presented in this 
chapter. When a subcommand can be abbreviated, its minimum 
abbreviation is shown in uppercase letters. 



Function 


Subcommand 


To create or edit a file 


Xedit 


To enter data 


Input 


To control case setting 


SET CASE 


To display file lines 


Type 


To move the line pointer 


Down 

Up 

TOP 

Bottom 


To move the column pointer 


CLocate 

CFirst 


To locate data 


CLocate 


To make changes to the file 


Change 
CInsert 
CDelete 
CAppend 


To recover deleted data 


RECover 


To insert one line 


Input line 


To delete lines 


DELete 


To replace a line 


Replace 


To move lines 


MOve 


To copy lines 


COpy 
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Function 


Subcommand 


To repeat a subcommand 


= 


To control special characters 


SET IMage 


To define logical tabs 


SET TABS 


To display tab settings 


Query TABS 


To display the logical record length 


Query LRecl 


To alter special character 


ALter 


To end an editing session without 
saving the changes 


QUIT 


To save automatically after 
changing a specified number of 
lines 


SET AUtosave 


To save the changed file when you 
have finished working on it 


FILE 


To store lines in temporary file for 
subsequent imbed in another 


PUT 


To imbed a complete or a partial 
copy of one file in another 


GET 


To simulate writing in the prefix 
area of the current line 


LPrefix 
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The ability to locate a line from a target is one of the editor's most versatile 
functions. 

Very simply, a target is a way that you identify a line to the editor. Targets 
are used to identify lines for two basic reasons: 

1. To change which line is the current line 

2. To define the operating range of a subcommand's execution. 
A target may be entered in the following ways: 

o By itself 

• As the operand of the LOCATE subcommand 

o Before any XEDIT subcommand 

o As the operand(s) in many other XEDIT subcommands. 

When a target is entered either by itself or as the operand of a LOCATE 
subcommand, the editor makes the target line the new current line. Entered 
before a subcommand, a target causes the editor to make the target line the 
new current line before it executes the subcommand. 

When a target is entered as the operand of various other XEDIT 
subcommands, it defines the range of that subcommand's execution. Most 
XEDIT subcommands begin their operation with the current line; the target 
operand is used to specify where the operation is to end. 

The following XEDIT subcommands have target operands: 
ALL EXPAND REPEAT 
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ALTER 

CHANGE 

COMPRESS 

COPY 

COUNT 

DELETE 

DUPLICAT 



EXTRACT 

HEXTYPE 

LOWERCAS 

MERGE 

MOVE 

PUT 

PUTD 



SET RANGE 

SET SELECT 

SHIFT 

SORT 

STACK 

TYPE 

UPPERCAS 



Refer to the publication VM/SP System Product Editor Command and 
Macro Reference for a complete description of the subcommand formats. 

There are various ways to specify any given target; all achieve the same 
result. How fancy you want to be depends on you. If you are a new user, 
you can specify targets in a simple way. As you become more experienced, 
you can take advantage of the flexibility that targets offer. 

A target can be expressed in the following ways: 

• An absolute line number 

• A relative displacement from the current line 
e A line name 

• A simple string expression 

• A complex string expression. 

You can use one or all of the above kinds of targets during an editing 
session; you can even use different kinds of target operands in the same 
subcommand. 



Using a Target to Change Which Line !s Current 



A Target Entered By Itself 



Look at Figure 21. When entered on the command line, any of the targets 
listed below would change the current line to the one shown in the bottom 
screen. (The current line is the line above the scale.) All the targets shown 
below are equivalent; which kind you use depends only on personal 
preference. How to use each kind of target is discussed throughout this 
chapter; the purpose of Figure 21 is to show you that there are various 
ways to identify any given line to the editor. 

====> :11 

(absolute line number) 
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====> +6 

(relative displacement from the current line) 

====> .CLAUDE 

(line name previously assigned by SET POINT) 

====> /egg/ 
(string) 

The editor begins searching for the target with the line following the 
current line; if the target line is located, it becomes the new current line. 

Notice that in the file identification line at the top of the screen, the 
"Line = " indicator shows that the current line has changed from line 5 (top 
screen) to line 11 (bottom screen). 
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TARGET1 SCRIPT 



Al V 132 Trunc=132 Size=14 Line=5 Col=l Alt=0 



00000 
00001 
00002 
00003 
00004 
00005 

00006 
00007 
00008 
00009 
00010 
00011 
00012 
00013 
00014 



* * * Top of File * • 
THE PHOENIX 

Deep in the study 
Of eugenics 
We find that fabled 
I ... + ... .1 + 2 



Fowl, the Phoenix. 

The wisest bird 

As ever was , 

Rejecting other 

Mas and Pas, 

It lays one egg, 

Not ten or twelve, 

And when it's hatched, 

Out pops itselve. 

/egg/ 



X E D I T 1 File 



TARGET1 SCRIPT Al V 132 Trunc=132 Size=14 Line=ll Col=l Alt=0 



00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 
00010 
00011 

00012 
00013 
00014 
00015 



Deep in the study 

Of eugenics 

We find that fabled 

Fowl, the Phoenix. 

The wisest bird 

As ever was , 

Rejecting other 

Mas and Pas , 

It lays one egg, 

I . . . + 1. ... + ... .2 



Not ten or twelve, 
And when it's hatched, 
Out pops itselve. 
* * * End of File * * * 






X E D I T 1 File 



Figure 21. Using a Target to Move the Line Pointer 
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3 '■■ 

A Target as the Operand of a LOCATE Subcommand 

3 

The targets listed above could have been specified as operands of the 
_] LOCATE subcommand, like this: 



====> LOCATE :11 

====> LOCATE +6 

====> LOCATE .CLAUDE 

====> LOCATE /egg/ 



_J You do not need to type "LOCATE" unless you want to. A target specified 

by itself implies the LOCATE subcommand; the name "LOCATE" is 
—j optional. 



A Target Preceding a Subcommand 



A target can be entered in the command line before any XEDIT 
_] subcommand. The editor first makes the target line the new current line, 

and then executes the subcommand. For example: 

3 
3 
3 



====> : 10 ADD 5 

The editor makes line 10 the new current line and then adds five lines to 
the file. 



~"| . This method is equivalent to entering a target, pressing the ENTER key, 

~ entering the subcommand, and pressing the ENTER key. Typing both the 

~j target and the subcommand in the command line and pressing the ENTER 

key only once saves you time. 

3 

' Using a Target as a Subcommand Operand 

I] 

When a subcommand format shows that an operand may be specified as a 
~i target, the target is usually used to tell the editor how many lines the 

subcommand is to execute upon; in other words, it defines the range of that 
~~| subcommand's operation. For example, a format of the UPPERCAS 

subcommand is: 

====> UPPERCAS target 

This format means, "starting with the current line, translate all lowercase 
characters to uppercase, up to, but not including, the target line." The 
translation is not executed on the target line itself. After execution, the 
last line translated becomes the new current line. 

Figure 22 is a before-and-after example of an UPPERCAS subcommand. 
When entered on the command line, any of the following subcommands 
would effect the translation shown in the bottom screen: 
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====> UPPERCAS : 14 
(absolute line number) 

====> UPPERCAS +4 

(relative displacement from current line) 

====> UPPERCAS .STOP 

(line name previously assigned) 

====> UPPERCAS /son/ 
(string) 



r 

L J 
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TARGET2 SCRIPT Al V 132 Trunc=132 Size=17 Line=10 Col=l Alt=0 

00001 WINTER COMPLAINT 

00002 Now when I have a cold 

00003 I am careful with my cold, 

00004 I consult my physician 

00005 And I do as' I am told. 

00006 I muffle up my torso 

00007 In woolly woolly garb, 

00008 And I quaff great flagons 

00009 Of sodium bicarb. 

00010 I munch on aspirin, 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. 

00011 I lunch on water, 

00012 And I wouldn't dream of osculating 

00013 Anybody's daughter, 

00014 And to anybody's son 

00015 I wouldn't say howdy, 

00016 For I am a sufferer 

00017 Magna cum laude. 

00018 * * * End of File * * * 



:===> UPPERCAS/son/ 



X E D I T 1 File 



TARGET2 SCRIPT Al V 132 Trunc=132 Size=17 Line=13 Col=l Alt=l 



00004 I consult my physician 

00005 And I do as I am told. 

00006 I muffle up my torso 

00007 In woolly woolly garb, 

00008 And I quaff great flagons 

00009 Of sodium bicarb. 

00010 I MUNCH ON ASPIRIN, 

00011 I LUNCH ON WATER, 

00012 AND I WOULDN'T DREAM OF OSCULATING 
J 00013 ANYBODY'S DAUGHTER, 

| . . . + 1 + 2 + 3 + 

-, 00014 And to anybody's son 

_J 00015 I wouldn't say howdy, 

00016 For I am a sufferer 

00017 Magna cum laude. 

00018 * * * End of File * * * 






X E D I T 1 File 
Figure 22. Using a Target as a Subcommand Operand 



Chapter 4. Using Targets 97 




Types of Targets 

Let's take a closer look at each of the ways to specify targets. 

A Target as an Absolute Line Number 

You can display line numbers in the prefix area by issuing the following 

subcommand: p 

====> SET NUMBER ON 

An absolute line number is represented as a colon (:) followed by the line 

number, for example, :10. i 

The following examples illustrate targets specified as absolute line ^ 

numbers: 

====> :50 

Make file line number 50 the new current line. I 

====> CHANGE /A/B/ :20 [~ 

Beginning with the current line, change "A" to "B" in every line up 
to, but not including, line 20. [ 

Figure 23 is a before- and- after example of a COUNT subcommand whose [ . 

target operand is specified as an absolute line number. The COUNT 

subcommand (top screen) means, "beginning with the current line, count [ 

how many times the string 'cone' appears in all lines up to but not 

including line 14." The string is counted only if it appears in the file [. 

exactly the way it is specified in the subcommand (in lowercase). 

When the ENTER key is pressed (bottom screen), notice that the last line 

searched (line 13) becomes the new current line, and the editor displays the 1 

message, "2 occurrences," in the message line. 

r 
r 
r 

r 
r 



r 
r 
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TARGET3 SCRIPT 



Al V 132 Trunc=132 Size=16 Line=8 Col=l Alt=0 



3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 



3 
3 

3 
u 
3 
u 
u 

3 
3 
3 
3 



00000 * * * Top of File * * * 

00001 TABLEAU AT TWILIGHT 
00002 

00003 I sit in the dusk, I am all alone. 

00004 Enter a child and an ice cream cone 

00005 A parent is easily beguiled 

00006 By sight of this coniferous child. 

00007 The friendly embers warmer gleam, 

00008 The cone begins to drip ice cream. 

I . . . + ..-.. 1 . . .. + ... .2. ... + .. ..3....+ 



00009 Cones are composed of many a vitamin. 

00010 My lap is not the place to bitamin. 

00011 Although my raiment is not chinchilla, 

00012 I flinch to see it become vanilla... 

00013 Exit child with remains of cone. 

00014 I sit in the dusk. I am all alone, 

00015 Muttering spells like an angry Druid, 

00016 Alone, in the dusk, with the cleaning fluid, 

00017 * * * End of File * * * 
====> COUNT /cone/ : 14 



X E D I T 1 File 



Al V 132 Trunc=132 Size=16 Line=13 Col=l Alt=0 



TARGET3 SCRIPT 
2 occurrences. 

00004 Enter a child and an ice cream cone. 

00005 A parent is easily beguiled 

00006 By sight of this coniferous child. 

00007 The friendly embers warmer gleam, 

00008 The cone begins to drip ice cream. 

00009 Cones are composed of many a vitamin. 

00010 My lap is not the place to bitamin. 

00011 Although my raiment is not chinchilla, 

00012 I flinch to see it become vanilla. . . 

00013 Exit child with remains of cone. 

I... + ....1.... + 2. ... + .. ..3. ... + ... 



00014 I sit in the dusk. I am all alone, 

00015 Muttering spells like an angry Druid, 

00016 Alone, in the dusk, with the cleaning fluid. 

00017 * * * End of File * * * 






Figure 23. A Target as an Absolute Line Number 



X E D I T 1 File 
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A Target as a Relative Displacement from the Current Line 



A relative displacement from the current line is an integer that means the 

target is a number of lines, either forward or backward, from the current 

line. The number may be preceded by a plus or minus sign, which indicates 

a forward ( + ) or backward ( — ) displacement from the current line. If the T 

sign is omitted, a plus ( + ) is assumed. 

r 

A relative displacement may also be specified as an asterisk (*), which 

means the Top of File ( - *) or End of File ( + * or *) line. When an asterisk [" 

is specified as the target operand of a subcommand, the subcommand 

executes to the end (or top) of the file. [ 

Examples: [ 

====> +3 r 

The target is three logical lines down (toward the end of the file) 
from the current line. [" 

-~> -5 r 

The target is five logical lines up (toward the top of the file) from 

the current line. r 

L 
====> +* 

The target is the null End of File (or End of Range) line. ' L 

The target is the null Top of File (or Top of Range) line. 

L. 

====> COPY +3 :25 

Copy three lines, starting with the current line, after line number ^. 

[ 

In this example, two targets are specified. The first ( + 3) is a r 

relative displacement from the current line; the second is an L 

absolute line number. 

L 

====> DELETE * 

Delete all lines from the current line to the end of the file. I. 

Figure 24 is a before-and-after example of a target specified as a relative i 

displacement. The target typed in the command line, +9, means, "move the r . 

current line nine logical lines forward, toward the end of the file." Notice I. 

that line numbers do not have to be displayed in the prefix area to use this 

kind of target. However, the "Line = " indicator in the file identification i 

area shows the old (Line = 10) and new (Line = 19) numbers of the current 

line. 
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TARGET4 SCRIPT Al V 132 Trunc=132 Size=28 Line=10 Col=l Alt=0 
===== THE PANTHER 

===== THE PANTHER IS LIKE A LEOPARD, 
===== EXCEPT IT HASN'T BEEN PEPPERED. 
===== SHOULD YOU BEHOLD A PANTHER CROUCH, 
===== PREPARE TO SAY OUCH. 

===== BETTER YET, IF CALLED BY A PANTHER, 
===== DON'T ANTHER. 

===== THE CANARY 

|...+....l.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. 

===== THE SONG OF CANARIES 
===== NEVER VARIES. 
===== AND WHEN THEY'RE MOULTING 
===== THEY'RE PRETTY REVOLTING. 

===== THE GIRAFFE 

===== i BEG YOU, CHILDREN, DO NOT LAUGH 
====> +9 

X E D I 



1 File 



3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 
3 



TARGET4 SCRIPT Al V 132 Trunc=132 Size=28 Line=19 Col=l Alt=0 

===== THE CANARY 

===== THE SONG OF CANARIES 
===== NEVER VARIES. 
===== AND WHEN THEY'RE MOULTING 
===== THEY'RE PRETTY REVOLTING. 

===== THE GIRAFFE 

===== I BEG YOU, CHILDREN, DO NOT LAUGH 

| ... + .... 1. . .. + ... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. ... + .. ..6. ... + .. ..7.. 
===== WHEN YOU SURVEY THE TALL GIRAFFE. 
===== IT'S HARDLY SPORTING TO ATTACK 
===== A BEAST THAT CANNOT ANSWER BACK. 
===== HE HAS A TRUMPET FOR A THROAT, 
===== AND CANNOT BLOW A SINGLE NOTE. 
===== IT ISN'T THAT HIS VOICE HE HOARDS; 
===== HE HASN'T ANY VOCAL CORDS. 
===== I WISH FOR HIM, AND FOR HIS WIFE, 
===== a VOLUBLE GIRAFTER LIFE. 

X E D I T 1 File 



Figure 24. A Target as a Relative Displacement 
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A Target as a Line Name 

Any line in a file can be assigned a name of one to eight characters 

preceded by a period (.), for example, .PART2. j 

You can use either the SET POINT subcommand or the .xxxx prefix [ 

subcommand to define a name(s) for a line. The SET POINT subcommand 

is 'used to define a name of one to eight characters, preceded by a period, to [ 

the current line. Using the .xxxx prefix subcommand allows you to define a 

name for any line in whose prefix area the name is entered; the name is one { 

to four characters, preceded by a period. 

r 

Assigning a name to a line makes it unnecessary for you to look up its line 

number or determine its relative displacement. Although the absolute line [ 

number of any given line can change during an editing session as lines are 

added or deleted from the file, a name stays with a line for the entire [ 

editing session. 

[" 

A line name is particularly useful if you plan to refer to a line many times 

during an editing session. You need assign the name only once; the line [ 

can then be referenced by its name at any time. It remains in effect only 

for the current editing session. Remember to type the line name exactly as [ 

it was when originally assigned to the line; the editor always pays attention 

to uppercase and lowercase characters when looking for a line name. L 

Examples: L 

1. Using the SET POINT subcommand to name a line: [ 

====> SET POINT .PART2 [" 

Assign the name ".PART2" to the current line. 

r 

====> TOP 

Move the line pointer to the Top of File line. ["' 

====> CHANGE /A/B/ .PART2 r 

Change "A" to "B" in every line, starting with the current line 
(in this case, the Top of File line) up to the line named r 

".PART2." 

2. Using the .xxxx prefix subcommand to name a line: 

To use the .xxxx prefix subcommand, type a name preceded by a period 

in the prefix area of any line on the screen, as illustrated below: f 

===== data r- ■ 

===== data 

===== data 

.STOP This is the line I want to name, [ 

===== data 

1 

[ 
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You can name any line on the screen with the .xxxx prefix 
"_] subcommand; the line does not have to be the current line, as it does 

with the SET POINT subcommand. After the ENTER key is pressed the 
~_] assigned name disappears from the prefix area and is replaced by equals 

signs or line numbers (depending on whether SET NUMBER OFF or 
'_] SET NUMBER ON is in effect). Then, you can refer to the line by 

using its assigned name. 

I] 

D 

====> .STOP 
^] Make the line named ".STOP" the new current line. 



Examples of using lines that have been already named: 



====> MOVE 1 .STOP 

Move the current line after the line named ".STOP". 



3 

3 

Note: After a name is assigned to a line, you must keep track of it. You 
_ ] can issue the subcommand QUERY POINT to display the name(s) of the 

current line, or you can use QUERY POINT * to display all names that 
~1 have been defined during the editing session. 

"'] Figure 25 is a before-and-after example of a DELETE subcommand that has 

its target operand specified as a line name. The line that contains "THE 

^] PARSNIP" was previously named ".STOP". The subcommand typed in the 

command line means, "beginning with the current line, delete lines up to 

H - but not including the line that has been assigned the name '.STOP'." 

3 
3 
3 
3 
3 
3 
3 



3 
3 
3 
3 
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TARGET5 SCRIPT Al V 132 Trunc=132 Size=13 Line=l Col=l Alt=0 



== * * * Top of File * * * 
== CELERY 

| ... + ... .1 + . . . .2 + . . . .3. . 

== CELERY, RAW, 

== DEVELOPS THE JAW, 

== BUT CELERY, STEWED, 

== IS MORE QUIETLY CHEWED. 

== THE PARSNIP 

== THE PARSNIP, CHILDREN, I REPEAT, 
=> DELETE .STOP 



X E D I T 1 File 



TARGETS SCRIPT Al V 132 Trunc=132 Size=6 Line=l Col=l Alt=l 
7 line(s) deleted. 



* * * Top of File * * * 
THE PARSNIP 

| ... + .... 1 .... + ..-. 2 .... + .... 3 .... + . 

THE PARSNIP, CHILDREN, I REPEAT, 
IS SIMPLY AN ANEMIC BEET. 
SOME PEOPLE CALL THE PARSNIP EDIBLE; 
MYSELF, I FIND THIS CLAIM INCREDIBLE 

* * * End of File * * * 






Figure 25. A Target as a Line Name 



X E D I T 1 File 
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A Target as a Simple String Expression 

1 

A target can be specified as one or more characters, that is, a string, 
J contained in a file line. The editor looks for the string, making the first 

line that contains it the target line. 

3 

If the string target is specified alone or as the operand of a LOCATE 
~_2 subcommand, the line containing the string becomes the new current line. 

If the string target is an operand of one of the other XEDIT subcommands, 
J the line that contains the string determines the range of the subcommand's 

execution. 

3 

The string must be enclosed in delimiters, which can be any character that 
'_] does not appear in the string itself. However, if you use one of the 

following special characters as a delimiter, you must also specify a search 
2 direction (+ or — ): plus ( + ), minus ( — ), not ( — i), or period (.). The search 

direction is explained below. 

3 

For example, the following is a string target, entered alone on the command 
_] line: 

""] ====> /whatever/ 



This means, "beginning with the line following the current line, search for 
the string 'whatever' and make the line that contains it the new current 
line." 



1 The following is an example of a string target used as the operand of a 

subcommand: 



====> DELETE /whatever/ 

This means, "delete all lines from the current line up to, but not including, 
the line that contains 'whatever'." 

The simplest way to specify a string target, as shown above, is one or more 
characters surrounded by delimiters. You can also: 

• Determine the direction of the search 

• Search for a line that does not contain a given string 

• Search for any of several strings. 



3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 , 

J " 
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Specifying a Search Direction 



By typing a plus ( + ) or minus ( — ) sign before a string target, you can tell 
the editor to search for a string in either a forward or backward direction 
from the current line. 

A plus sign in front of a string target means that the search for the string 
starts at the line following the current line in a forward direction, toward 
the end of the file. If the string is found, the line that contains it becomes 




the new current line. If a sign is omitted, a plus is assumed. The following 
targets are equivalent: 



: ==> /whatever/ 



and 



====> +/whatever/ 



You can also specify that the search occur backward in the file by typing a 
minus sign before the string target. 

For example: 

====> -/whatever/ 

means, "search backward in the file, starting with the line preceding the 
current line, and make the line containing the string the new current line." 

Let's look at some more examples: 

====> DELETE /rosebud/ 

Delete lines beginning with the current line, up to but not including 
the line containing "rosebud". 

====> COPY /daisy/ -/petunia/ 

Copy lines starting with the current line, up to the line containing 
"daisy", and insert them after the line containing "petunia", which 
is located in a backward direction from the current line. 



====> put /Chapter2/ 

Put lines from the current line, up to the line that contains 
"Chapter2". 



Using a "NOT" Symbol (~i) 



Using an "OR" Symbol (|) 



You can precede any string target with a NOT symbol (~ i), which means 
that the target is a line that does not contain the specified string. For 
example: 

====> -i/Part Number/ 

Beginning with the line following the current line, locate a line that 
does not contain "Part Number" and make it the new current line. 

====> MOVE 1 -i/Part Number/ 

Move the current line after the first line that does not contain "Part 
Number". 



A string target can comprise multiple strings, separated by an "OR" symbol, 
each enclosed in delimiters. The editor searches the file one line at a time. 
The first line that contains one of the specified strings becomes the current 
line. For example: 



If a file contains the following lines: 
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===== apples 
_ ] ===== peaches 

===== plums 
-■■, ===== pears 

— > ===== oranges 

-J The following subcommand: 

_] ====> Locate /oranges/ | /pears/ | /peaches/ 

_J will make the following line current: 

~'i ===== peaches 

- j Using an "AND" Symbol (&) 

— | You may use an "AND" symbol in the same way that you use the "OR" 

symbol. The editor searches the file one line at a time and the first line 

~i that contains all of the strings specified becomes the current line. For 

example: 

~ If a file contains the following lines: 

— I ===== Truffles, Leg of Lamb, Chocolate Mousse 

===== Turkey eggs, Leg of Lamb, Savarin 
^J ===== Escargot, Leg of Lamb, Bombe 

_] the following subcommand: 

'"] ====> Locate /Leg of Lamb/s/Bombe/ 

""] will make the following line current: 

-_-, ===== Escargot, Leg of Lamb, Bombe 

_J 

._ -, A Summary of Simple String Targets 

-, You've seen how to specify a target as a single string, enclosed in 

— - I delimiters. You've also seen how a plus or minus sign, a NOT symbol, an 

— , OR symbol, and an AND symbol can be used to further define a string. 



In addition, all of these features can be combined to define a single target, 
that is, a single string, enclosed in delimiters, can be preceded by a plus or 
minus sign and a NOT symbol. Two or more strings may be separated by OR 
and/or AND symbols. 

Furthermore, if the subcommand SET HEX ON is in effect, a string may be 
specified in hexadecimal notation, for example, /X'C3D4E2'/. 

The following chart summarizes the format of a simple string expression: 
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[+|-] [-i]/stringl[/&[-i]/string2/[ I [-i]/string3/] ] . . . 

12 3 4 5 



1 The search direction is toward the end of the file ( + ) or toward the top 
of the file ( — ). If the sign is omitted, a plus ( + ) is assumed. 

2 "NOT" symbol (locate something that is not the specified string) 

3 Character (or hexadecimal) string. 

4 "AND" symbol (ampersand)(Locate the line containing stringl and 
string2.) 

5 "OR" symbol (vertical bar)(Locate the line containing stringl and 
string2 or string3.) 

Examples: 

== -=> /horse/ 

searches downward in the file, beginning after the current line, for 
the first line that contains "horse" and makes it the current line. 

====> -i/house/ 

searches downward in the file for the first line that does not contain 
"house" and makes it the current line. 

====> /horse/ & /house/ | /hay/ 

searches downward in the file for the first line that contains both 
"horse" and "house" or that contains "hay," whichever occurs first. 

====> /horse/ | -i /house/ 

searcucs uownwaru in tue ii±e ior tue iirst line tiiat contains norse" 
or does not contain "house". 

====> -/x'ci'/IA^'/ 

searches upward for the first line containing either or both of the 
strings specified here in hexadecimal (if SET HEX ON has been 
issued). 

If SET HEX ON is in effect, the editor locates a line containing "A" 
or "B." If SET HEX OFF is in effect, the editor locates a line 
containing "X'Cl"' or "X'C2\" 

Figure 26 is a before-and-after example of a target specified as a simple 
string expression. The target typed in the command line means, "beginning 
with the line following the current line, search for a line that either does 
not contain 'Experience' or for a line that does contain 'experience', and 
make it the new current line." 
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TARGET6 SCRIPT Al V 132 Trunc=132 Size=8 Line=0 Col=l Alt=0 



== * * * Top of File * * * 

| . . . + 1 + 2 + ....3 + .. 

: = Experience is a futile teacher, 

: = Experience is a prosy preacher, 

: = Experience is a fruit tree fruitless, 

== Experience is a shoe-tree bootless... 

== For sterile wearience and drearience, 

: = Depend, my boy, upon experience. 

: = I'd trade my lake of experience 

== For just one drop of common sense. 

== * * * End of File * * * 

: > -i/Experience/ | /experience/ 



X E D I T 1 File 



3 



TARGET6 SCRIPT Al V 132 Trunc=132 Size=8 Line=5 Col=l Alt=0 



* * * Top of File * * * 
Experience is a futile teacher, 
Experience is a prosy preacher. 
Experience is a fruit tree fruitless, 
Experience is a shoe-tree bootless... 
For sterile wearience and drearience, 

| . . . + 1 + 2 + 3 + 4 

Depend, my boy, upon experience. 
I'd trade my lake of experience 
For just one drop of common sense. 

* * * End of File * * * ' 






3 






X E D I T 1 File 



Figure 26. A Target as a Simple String Expression 



3 
3 
3 
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A Target as a Complex String Expression 



A complex string expression has the same format as a simple string 

expression (see above), but any string can be expressed as a "complex <■ 
string," which is a string associated with one or more of the following SET 

subcommand options: i 

SET ARBCHAR i 
allows you to specify only the beginning and end of a string, using 

an arbitrary character to represent all characters in the middle. i 

SET CASE I 
allows you to specify whether or not the difference between 

uppercase and lowercase is to be significant in locating a string l 

target. r 

SET SPAN 

allows you to specify if a string target must be included in one file 

line or if it may span a specified number of lines. r 

SET VARBLANK r 

allows you to control whether or not the number of blank L 

characters between two words is significant in a target search. r 

i 

You can use one or more of these options to suit your individual text r 

processing needs. Each of the options is assigned an initial setting by the *- 

editor. You can alter the setting one or more times during an editing r 
session by issuing the appropriate SET subcommand. (See the publication 

VM/SP System Product Editor Command and Macro Reference for a r 

complete description of these SET subcommand options.) L 



Using a Target with SET ARBCHAR 



When SET ARBCHAR ON is in effect, you can use a dollar sign ($), which l 

is the default arbitrary character, to represent all characters between the r 

beginning and end of a string target. l 

Examples: 

====> /air$plane/ L 

r 

The beginning of the string is "air"; the end of the string is "plane". The i 

dollar sign is the arbitrary character and represents any characters 

between "air" and "plane". This string target causes the editor to locate I 

either of the following file lines, and makes current whichever line comes 

first: I 

===== The airplane landed. [" 

===== Cold air surrounded the plane. r- 
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Using a Target with SET CASE 

You can specify whether the editor is to respect or ignore the difference 
between uppercase and lowercase representations of alphabetic letters by 
using the SET CASE subcommand. 

The following subcommand tells the editor that uppercase and lowercase 
representations of the same letter do not match: 

====> SET CASE MIXED RESPECT 

For example, if a file contains the following line: 

===== The Text Editor 

The following string target will not locate that line: 
====> /the text editor/ 

On the other hand, the following subcommand tells the editor to ignore the 
difference between uppercase and lowercase: 

====> SET CASE MIXED IGNORE 

With this setup, in the example above, the line would be located. 

Using a Target with SET SPAN 

Usually, a string must be included in a single file line in order to be 
located. You can use the SET SPAN subcommand to specify that a string 
target may span a specified number of lines and still be located. The line 
that contains the beginning of the string becomes the new current line. 

In a text file, like a SCRIPT file, a blank separates each file line. The 
following subcommand tells the editor that a string target may span two 
lines, separated from each other by a blank: 



_] ====> SET spAN on BLANK 2 

_] The string target: 

~] ====> /twigs to probe/ 

_ l would locate in the file: 

— , ===== Woodpecker finches of the Galapagos Islands use twigs 
J ===== to probe holes in tree trunks for edible insects. 

—J The string "twigs to probe" begins on one line and ends on the next. 

3 



3 
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Using a Target with SET VARBLANK 



The SET VARBLANK subcommand can be used to control whether or not 
the number of blank characters between two words is significant in a target 
search. 

SET VARBLANK ON means that the number of blanks between two words 
can vary; the number of intervening blanks specified in a string target does 
not have to be equal to the number in the file. 

For example: 

====> /the house/ 

would locate either of the following lines in the file: 

===== the house 

===== the house 

If SET VARBLANK OFF is in effect (the initial setting), the number of 
blanks between two words is significant in a target search. In the above 
example, only the second line would be located. 



Combining the SET Options 



You can tailor the SET options, ARBCHAR, CASE, SPAN, and 
VARBLANK to meet your particular text processing needs. For example, 
with SET ARBCHAR ON, SET CASE MIXED IGNORE, SET SPAN ON 
BLANK 2, and SET VARBLANK ON, you can: 

• Specify only the beginning and end of a string target 

• Locate a string whether it is in uppercase or lowercase 

• Allow the string target to locate a string that starts on one line and 
ends on another 

• Disregard the number of intervening blanks between two words. 

Figure 27 is a before-and-after example of using a target specified as a 
complex string expression. 

The following subcommands were issued: 

====> SET ARBCHAR ON $ 
====> SET CASE MIXED IGNORE 
====> SET SPAN ON BLANK 2 

The string target typed in the command line locates the line shown in the 
bottom screen. The ARBCHAR option allows the beginning and end to be 
specified; the CASE option allows the string to be specified in lowercase 
even though it appears in the file in both uppercase and lowercase; the 
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SPAN option allows the beginning and end of the string to be located on 
two consecutive lines. 



TARGET7 SCRIPT Al V 132 Trunc=132 Size=19 Line=10 Col=l Alt=0 

===== MORE ABOUT PEOPLE 

===== when people aren't asking questions 

===== They're making suggestions 

===== And when they're not doing one of those 

===== They're either looking over your shoulder or stepping on your toes 

-=--= And then as if that weren't enough to annoy you 

===== They employ you. 

===== Anybody at leisure 

===== Incurs everybody's displeasure. 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7. 
===== it seems to be very irking 

===== To people at work to see other people not working. 
===== so they tell you that work is wonderful medicine, 
===== Just look at Firestone and Ford and Edison, 

===== And they lecture you till they're out of breath or something 
===== And then if you don't succumb they starve you to death or something. 
===== All of which results in a nasty quirk: 

===== That if you don't want to work you have to work to earn enough money 
===== so that you won't have to work. 
====> +/f ire$breath/ 

X E D I T 1 File 



"1 



:j 
:j 
u 

u 



u 
u 



TARGET7 SCRIPT Al V 132 T.runc=132 Size=19 Line=14 Col=l Alt=0 

===== And when they're not doing one of those 

===== They're either looking over your shoulder or stepping on your toes 

===== And then as if that weren't enough to annoy you 

===== They employ you. 

===== Anybody at leisure 

===== Incurs everybody's displeasure. 

===== It seems to be very irking 

===== To people at work to see other people not working. 

===== so they tell you that work is wonderful medicine, 

===== Just look at Firestone and Ford and Edison, 

| ...+... .1. . ..+... .2. ...+.». .3. ...+.. ..4. ...+.. ..5. ...+.. . .6. ...+.. ..7 
===== And they lecture you till they're out of breath or something 
===== And then if you don't succumb they starve you to death or something. 
===== All of which results in a nasty quirk: 

===== That if you don't want to work you have to work to earn enough money 
===== so that you won't have to work. 
===== * * * Enc j of File * * * 






X E D I T 1 File 



"1 Figure 27. A Target as a Complex String Expression 
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Using Column-Targets 



The targets discussed so far effect line pointer movement, that is, if the 
editor locates the target, the line pointer is moved. However, the column 
pointer is not moved. Furthermore, if a target is expressed as a string, only 
the first occurrence of the string is located in a line. 

The CLOCATE subcommand operates on a specialized operand called a 
column-target. This subcommand is used to locate all occurrences of a 
string throughout a file and to move the column pointer. The format of the 
CLOCATE subcommand is as follows: 

====> CLOCATE column-target 

where the column-target can be expressed as an absolute column number, a 
relative displacement from the current column, or a string expression. 

The following examples show the various ways to express a column-target. 
Notice how the column pointer moves after each subcommand is executed. 



Current Line: 



-== John Keats studied medicine and practiced as an apothecary. 
| . . . + 1 + 2 + 3 + 4 + 5 + 6 

■=> CLOCATE :6 

(absolute column number) 

: == John Keats studied medicine and practiced as an apothecary. 
<. . . + | . . .1 + 2 + 3 + 4 + 5 + 6 



Current Line: 

===== James Joyce was a school teacher in Dublin. 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4....+. 



: => CLOCATE +6 
(relative column number) 



James Joyce was a school teacher in Dublin. 
<. . . + . I . . 1. . ..+... .2. ... + .. ..3. ... + .. ..4... .+ 



Current Line: 



== Herman Melville worked as a customs inspector in N.Y.C. 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7 

: > CLOCATE /customs/ 

: = Herman Melville worked as a customs inspector in N.Y.C. 

<... + 1 + 2 + . . . | 3 + ....4 + 5 + 6 + ....7 
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Current Line: 



Charles Dickens served as a law clerk and was a reporter. 
I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6 



—] ====> CLOCATE /reporter/ | /clerk/ 

===== Charles Dickens served as a law clerk and was a reporter. 
_] <... + ... . 1. ... + ... .2. ... + ... .3. ... + ... .4. ... + ... | 5. . .. + ... .6. ... + .. ..7... 

3 

The CLOCATE subcommand scans the file, starting with the column 
~1 following (or preceding, depending on the search direction) the column 

pointer in the current line, for the specified column target, and moves the 
~j column pointer to the target, if it is located. In addition, the line pointer is 

moved (if necessary), so that CLOCATE can be used successively to locate 
] all occurrences of a string in a file. 

_] CLOCATE is also necessary because various subcommands perform their 

operations based on the position of the column pointer. The CLOCATE 

^J subcommand is first used to position the column pointer; then another 

subcommand that operates based on the position of the column pointer can 

]3 be used. 

2] The following is a list of all subcommands that operate based on the 

position of the column pointer. 

I] - 

CAPPEND 

_ J Appends text to the end of the current line, and moves the column 

pointer under the appended text. 

u 

7" CDELETE 

^] Deletes one or more characters from the current line, starting at the 

column pointer, up to a column-target. 

H 

CFIRST 

__J Moves the column pointer to the beginning of the line. 



] CINSERT 

Inserts character(s) in a line, starting at the column pointer. 



CLAST 

Moves the column pointer to the end of the line. 



J CLOCATE 

Moves the column pointer to a specified column-target. 

COVERLAY 

I Replaces characters in the current line, starting at the column 

_ pointer; blanks in the operand do not overlay characters in the file 

_J line. 



I] 



CREPLACE 
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Replaces characters in the current line, starting at the column 
pointer; characters can be replaced with blanks. 

These subcommands are discussed in detail in the publication VM/SP 
System Product Editor Command and Macro Reference. Column-targets are 
discussed in that book in the "Usage Notes" section of the CLOCATE 
subcommand. 

The following examples illustrate how to use the CLOCATE and CDELETE 
subcommands to delete a word: 

=== If anything can go wrong, it will. 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7... 

: => CLOCATE / wrong/ 

(Move column pointer under first character of string to be deleted.) 

=== If anything can go wrong, it will. 

<... + 1 + . . . |2 + 3 + 4 + 5 + 6 + ....7... 

==> CDELETE /,/ 

(Delete from column pointer up to the comma.) 

: == If anything can go, it will. 

<... + 1 + ...12 + 3 + 4 + 5 + 6 + ....7... 
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The XEDIT Subcommand 



When you issue the CMS command XEDIT, a copy of the specified file is 
brought into virtual storage, where it remains until you issue a FILE or 
QUIT subcommand. In other words, the XEDIT command brings one file at 
a time into storage. By entering the XEDIT subcommand during an editing 
session, you can bring more than one file into virtual storage at a time. 

The format of the XEDIT subcommand is identical to that of the XEDIT 
command and is as follows: 

====> Xedit [fn [ft [fm] ] ] [ (options ...[)] ] 

For a complete description of the XEDIT subcommand operands, refer to 
the publication VM/SP System Product Editor Command and Macro 
Reference. 



Creating a Ring of Files in Storage 



Multiple files are kept in virtual storage in a "ring." Each time you issue 
an XEDIT subcommand with a new fileid, a file is added to the ring and 
becomes the current file, which is the file that is displayed. 

A file remains in the ring until a FILE or QUIT subcommand is issued for 
that file; then the preceding file in the ring is displayed. The number of 
files you can edit simultaneously is limited only by your virtual storage 
size. 

Figure 28 illustrates a ring of files in storage. 



3 
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FILE A 



FILEB 



FILEC 



Figure 28. A Ring of Files in Storage 



By issuing the following subcommand, you can display the number of files 
in the ring and the file identification line of each file: 

====> QUERY RING 



Editing the Files in the Ring 



The order in which you can edit the files in the ring depends on how you 
specify the XEDIT subcommand: 

• If you issue the XEDIT subcommand without operands, the next file in 
the ring appears on the screen. (See Part 1 of Figure 29.) Therefore, a 
series of XEDIT subcommands issued without operands allows you to 
switch from the first file to the second, the second to the third, and so 
forth, all the way around the ring and back to the first file. 

• You can alter this sequence by issuing the XEDIT subcommand with 
the fileid of a file in the ring. The specified file becomes the current file 
and appears on the screen, regardless of its relative position in the ring. 
(See Part 2 of Figure 29.) 

• If you issue an XEDIT subcommand with a fileid of a file that is not 
already in the ring, that file is added to the ring just after the current 
file and is displayed. (See Part 3 of Figure 29.) 

• If the XEDIT subcommand is issued with a fileid and the file does not 
exist, that file is created, added to the ring just after the current file, 
and displayed. 
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Current File (*) 



FILE A 



FILE A 



FILE B 





FILE B 




XEDIT Subcommand 



===> XEDIT 



===> XEDIT FILEB 



===> XEDIT FILED 



Figure 29. Editing Files in the Ring 



New Current File (*) 




FILE A 



FILE D 



FILE A 




/ 




* l 




FILE B 
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FILE C 





FILE B 



FILE C 
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Ending an Editing Session 



When you are finished editing a particular file, you can issue a FILE or 
QUIT subcommand for that file. The file is removed from the ring, and the 
previous file in the ring is displayed. 

To end the editing session for all of the files and return control to CMS, use 
the CANCEL macro, whose format is as follows: 

====> CANCEL 

Issuing the CANCEL macro is equivalent to issuing a QUIT subcommand 
for each file in the ring. If any of the files were modified, the usual 
warning message is displayed for each of those files: 



'J 
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File has been changed. Use QQUIT to quit anyway. 

You can then issue either QQUIT or FILE. 

If none of the files being canceled were modified, control is immediately 
returned to CMS. 



Multiple Logical Screens 



Up until now, we have been discussing editing multiple files with one file, 
the current file in the ring, displayed at a time. By using the SET SCREEN 
subcommand, you can divide the physical screen into multiple logical 
screens. The screen can be split vertically, horizontally, or in a 
combination of vertical and horizontal segments. You can display a 
different file from the ring in each logical screen, or you can display 
multiple views of the same file. 

Each logical screen looks and functions like the physical screen. Each one 
becomes, in effect, an independent terminal with its own file identification 
line, command line, and message line. For more information about multiple 
logical screens, refer to the publication VM/SP System Product Editor 
Command and Macro Reference. 



SET SCREEN Subcommand 



Issuing the command, SET SCR 2, will split the screen horizontally into two 
screens, one on top of the other. 

The command SET SCR 2 V, will split the screen vertically into two 
screens, one beside the other. 

Using the SIZE option with the SET SCREEN subcommand allows you to 
create horizontal screens with the number of lines that you specify. For 
example, SET SCR SIZE 14 10, will create two screens, one with 14 lines, 
and another with 10 lines. 

Likewise, the WIDTH option is used to specify the number of columns each 
vertical screen will contain. If SET SCR WID 25 25 30 is issued, 3 vertical 
screens are created, the first with 25 columns, the second with 25 columns, 
and the third with 30 columns. 

The initial setting of the SCREEN option is SCREEN SIZE n, where n is 
the physical screen size. 

To return to the initial setting, issue the following subcommand: 
====> SET SCREEN 1 
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For more information about this command, refer to the publication, VM/SP 
_] System Product Editor Command and Macro Reference. 

Multiple Views of the Same File 

If only one file is in virtual storage and you issue a SET SCREEN 
""] subcommand, identical views of the file appear on the screen. 

~j Figure 30 is a before-and-after example of a SET SCREEN subcommand 

that creates two views of the same file. 

:j 

Making Changes from Multiple Views of the Same File 

J 

You can edit a file by typing over the data in any of the views, and by 

""] entering subcommands in any of the command lines and prefix areas. You 

can type related prefix subcommands in different views of a file, even when 

"J different parts of the file are displayed. For example, you can type a "C" 

(copy) prefix subcommand in one view, and a "P" (preceding) prefix 

J subcommand in another view. Changes made to the file from one logical 

screen are reflected immediately in all screens. 

"J 

However, subcommands that control the screen display, for example, 
~J FORWARD, affect only that screen from which they were issued. 

Therefore, you can see different parts of a file at the same time. 

3 ■■ 

Similarly, PF keys assigned to screen movement subcommands are executed 
__] only on the view that contains the cursor when the PF key is pressed. 

u 

3 

:j 
:j 
:.'] 
:.] 
:j 
:j 

3 
3 

3 ,- 
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NASH 



SCRIPT Al V 132 Trunc=132 Size=6 Line=6 Col=l Alt=0 



* * . * Top of File * * * 
THE OCTOPUS 

TELL ME, OCTOPUS, I BEGS, 

IS THOSE THINGS ARMS, OR IS THEY LEGS? 

I MARVEL AT THEE, OCTOPUS: 

IF I WERE THOU, I'D CALL ME US. 

|...+....l.. ..+... .2. ...+.. ..3. ...+... .4. 

* * * End of File * * * 



====> SET SCREEN 2 



X E D I T 1 File 



NASH SCRIPT Al V 132 Trunc=132 Size=6 Line=6 Col=l Alt=0 

===== TELL ME, O OCTOPUS, I BEGS, 

===== IS THOSE THINGS ARMS, OR IS THEY LEGS? 

===== i MARVEL AT THEE, OCTOPUS: 

===== IF I WERE THOU, I'D CALL ME US. 

| ... + .... 1. . ..+... .2. ... + .. ..3. ... + .. ..4. ... + .. ..5. ... + .. ..6. ...+.. ..7.. 
===== * * * End of File * * * 

X E D I T 1 Fixe 
NASH SCRIPT Al V 132 Trunc=132 Size=6 Line=6 Col=l Alt=0 

===== TELL ME, OCTOPUS, I BEGS, 

===== IS THOSE THINGS ARMS, OR IS THEY LEGS? 

===== i MARVEL AT THEE, OCTOPUS: 

===== IF I WERE THOU, I'D CALL ME US. 

| ...+.... 1. . ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. . .6. ...+.. . .1 . , 
===== * * * End of File * * * 

X E D I T 1 File 
Figure 30. Multiple Horizontal Views of the Same File 
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Multiple Views of Different Files 

When multiple files are being edited and you issue a SET SCREEN 
-J subcommand that increases the number of logical screens, the additional 

screens are immediately filled with files selected from the ring. 



Figure 31 illustrates how additional logical screens are filled with files 
-J from the ring. The ring of files contains files named FILE1 and FILE2; the 

current file is FILE1. The SET SCREEN subcommand shown in the top 
-3 screen causes another file to be displayed. 



If a SET SCREEN subcommand decreases the number of logical screens, 
files are displayed as long as logical screens are available. Those files for 
which logical screens are not available are removed from the display. 

Issuing an XEDIT subcommand from one of multiple screens is just like 
issuing it when there is only one screen. It does not affect the other logical 
screens. In all cases, the file is displayed only on the screen from which the 
XEDIT subcommand was issued. 

The status area of all the screens displays the number of files in virtual 
storage, not the number of screens. 



Order of Processing 



You can type over the data, type subcommands on the command line, and 

1 type prefix subcommands and macros in the prefix area of all views of a 

file(s) before pressing a key (like the ENTER key) that effects the changes. 

_ The editor processes requests typed on different views in the following 

._J order: 

1 I 1. Changes typed over the data in all the views are made first. Changes 

are processed in the order that the data lines appear on the physical 
I screen, from the top, moving left to right, to the bottom. 

. — I 2. Prefix subcommands and macros are executed next, as follows: 

. — I All prefix subcommands and macros are placed in a "pending list" 

before they are executed. Only one pending list is executed for each 

. — I file, regardless of the number of views of that file. However, the other 

views of a file are updated to reflect the changes. 



The pending list is executed from the first view of each file or from the 
view that contains the cursor, if any view does. This means that all 
messages from prefix subcommands and macros will be displayed in the 
screen from which the pending list was executed. Cursor positioning 
for prefix subcommands and macros is determined by what lines are 
displayed in the screen with the cursor. Note that when multiple files 
are displayed, one pending list is executed for each file, and all views 
reflect the changes. See other CURSOR considerations below. 
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For more information on the pending list, see Chapter 7 in this book. 

3. Subcommands typed on the command lines are executed last and in the 
following order: 



With multiple horizontal screens, the command lines are processed from 
the top view to the bottom view. With multiple vertical screens, the 
command lines are processed left to right. With a combination of 
horizontal and vertical screens, the command lines are processed in the 
same order that the screens were defined in the SET SCREEN DEFINE 
subcommand. 



Cursor Considerations 



The cursor remains in the view that contained it when the ENTER key (or 
PA/PF key) was pressed. This is true even if a CURSOR subcommand is 
issued in another view. If no view of a file contained the cursor (for 
example, if part of the physical screen was left undefined and your cursor 
was positioned there), then the cursor is placed in the first logical screen on 
the physical screen (the top-most screen for horizontal views, the left-most 
screen for vertical views, or the first view defined via SET SCREEN 
DEFINE). 



You can move the cursor from one logical screen to another by issuing SOS 
TABCMDF or SOS TABCMDB. 

For more information on the SET SCREEN subcommand, refer to the 
publication VM/SP System Product Editor Command and Macro Reference. 
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FILE1 



SCRIPT 



Al V 132 Trunc=132 Size=7 Line=0 Col=l Alt=0 



U 
J 
U 
3 
3 
3 
3 



: = * * * Top of File * * * 

I...+....1.. ..+... .2. ...+.. ..3... .+. 

== THE PANTHER 

== THE PANTHER IS LIKE A LEOPARD, 

== EXCEPT IT HASN'T BEEN PEPPERED. 

== SHOULD YOU BEHOLD A PANTHER CROUCH, 

== PREPARE TO SAY OUCH. 

== BETTER YET, IF CALLED BY A PANTHER, 

== DON'T ANTHER. 

== * * * End of File * * * 

: > set screen 2 v 



X E D I T 2 Files 



3 



FILE1 



SCRIPT 



Al V 132 Trunc=132 FILE2 



SCRIPT 



Al V 132 Trunc=132 



u 

ZJ 

n 



* * * Top of File * * * ===== * * * Top of File * * * 

| ...+... .1. . ..+... .2. ...+.. ..3... | ...+... .1. . ..+... .2....+. 

THE PANTHER ===== THE CANARY 

THE PANTHER IS LIKE A LEOPARD, ===== THE SONG OF CANARIES 

EXCEPT IT HASN'T BEEN PEPPERED. ===== NEVER VARIES. 

SHOULD YOU BEHOLD A PANTHER CROUC ===== AND WHEN THEY'RE MOULTING 

PREPARE TO SAY OUCH. ===== THEY'RE PRETTY REVOLTING. 

BETTER YET, IF CALLED BY A PANTHE ===== * * * End of File * * * 

DON'T ANTHER. 

* * * End of File * * * 









Figure 31. Multiple Vertical Views of Different Files 
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Prefix Area 



Command Line 
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By using the following SET subcommand options, you can tailor the 
full-screen layout to suit your preferences: 

SET PREFIX 
SET CMDLINE 
SET MSGLINE 
SET CURLINE 
SET SCALE 
SET TABLINE 
SET COLOR 
SET NUMBER 

For a complete description of these options, refer to the SET subcommand 
description in the publication VM/SP System Product Editor Command and 
Macro Reference. 

The areas of the screen that can be changed are discussed below. 



Use the SET PREFIX subcommand to control the display of the prefix area. 
You can display the prefix area on the left or the right side of the screen, or 
you can remove the prefix area from the display or you can set NULLS in 
the prefix area. Initially, the prefix area is displayed on the left. 



Use the SET CMDLINE subcommand to move the command line to the 
same line as the message line (the second line of the screen), to the last line 
of the screen, or remove the command line from the screen. Initially, the 
command line is the last two lines of the screen. If you move the command 
line to the message line or the last line, the status area is not displayed. 

With SET CMDLINE TOP (command line on line 2) and the default SET 
MSGLINE setting (line 2), a message overlays the command line, including 
the arrow. You must press the ENTER or CLEAR key to recover the 
command line. To avoid this situation, assign the message line to line 1 or 
line 3 when using CMDLINE TOP. 



I] 
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Message Line 



Current Line 



Scale 



Tab Line 



Use the SET MSGLINE subcommand to define the location of the message 
line on the screen, and the number of lines the message may expand to, to 
avoid clearing the screen to display the message. It may also be used to 
override the blank line that is normally displayed on the screen for 
messages. 



Use the SET CURLINE subcommand to define a specified line of the screen 
as the current line. Initially, the current line is in the middle of the screen. 

Remember that the editor uses the first line of the screen for the file 
identification line. Therefore, if you want the current line to be the first 
available screen line, use the subcommand SET CURLINE ON 2. 

One reason you might want to change the position of the current line is to 
vary the size of the input zone. When you issue an INPUT subcommand, 
the editor provides an input zone between the current line and the 
command line. To get a larger input zone, move the current line higher on 
the screen; to get a smaller input zone, move it lower on the screen. 



Use the SET SCALE subcommand to move the scale to a specified line, or 
to remove the scale from the display. Initially, the scale is positioned under 
the current line. If you move the current line, you probably also will want 
to move the scale. 



Use the SET TABLINE subcommand to display, on a specified line, a "T" in 
every tab column, according to the current tab settings (as defined by the 
SET TABS subcommand). Initially, a tab line is not displayed. If you 
change the tab settings during an editing session, the tab line will reflect 
that change, that is, the "T"s will be placed in the new tab columns. 



Color 



Depending on the features supported by your terminal, you can use the SET 
COLOR subcommand to associate specific colors, highlighting, extended 
highlightings, and programmed symbol set features with various physical 
locations on the screen. The physical locations include the arrow, current 
line, file area, prefix area, command line, scale line, tab line, file 
identification line, pending message display area, shadow line, status area, 
top of file and end of file lines, and the message line. Colors associated 
with those areas can be: blue, red, pink, green, turquoise, yellow, white, or 
your default terminal display color. You can accentuate this capability by 
using programmed symbol sets or extended highlighting features such as 
blinking, reverse video, and underlining. 
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Number 



For a complete explanation of this function refer to the publication, VMjSP 
System Product Editor Command and Macro Reference. 



Use the SET NUMBER subcommand to specify whether the prefix area 
should contain line numbers. Initially, equal signs are used. 

Figure 32 through Figure 37 illustrate how some of the subcommands 
discussed above are used to tailor the screen. Notice how the screen 
changes when the subcommand shown in the command line of each screen 
is executed. 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=2i 

===== * * * To p of F ii e * * * 
===== the PANTHER 

===== THE PANTHER IS LIKE A LEOPARD, 
===== EXCEPT IT HASN'T BEEN PEPPERED. 
===== SHOULD YOU BEHOLD A PANTHER CROUCH, 
===== PREPARE TO SAY OUCH. 

===== BETTER YET, IF CALLED BY A PANTHER, 
===== DON'T ANTHER. 

| . . . + 1 + 2 + 3 + 4 

===== THE CANARY 

===== THE SONG OF CANARIES 
===== NEVER VARIES. 
===== AND WHEN THEY'RE MOULTING 
===== THEY'RE PRETTY REVOLTING. 

===== THE GIRAFFE 

====> SET PREFIX ON RIGHT 



Line=9 Col=l Alt=0 



X E D I T 1 File 



TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 

* * * Top of File * * * ==== 

THE PANTHER ==== 

THE PANTHER IS LIKE A LEOPARD, ==== 

EXCEPT IT HASN'T BEEN PEPPERED. ==== 

SHOULD YOU BEHOLD A PANTHER CROUCH, ===== 

PREPARE TO SAY OUCH. ==== 

BETTER YET, IF CALLED BY A PANTHER, ==== 

DON'T ANTHER. ==== 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7... 

THE CANARY ==== 

THE SONG OF CANARIES ==== 

NEVER VARIES. ===== 

AND WHEN THEY'RE MOULTING ===== 

THEY'RE PRETTY REVOLTING. ==== 

THE GIRAFFE ==== 

X E D I T 1 File 

Figure 32. The SET PREFIX Subcommand - "Before" and "After" 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 

* * * Top of File * * * ==== 

THE PANTHER ==== 

THE PANTHER IS LIKE A LEOPARD, ==== 

EXCEPT IT HASN'T BEEN PEPPERED. ==== 

SHOULD YOU BEHOLD A PANTHER CROUCH, ==== 

PREPARE TO SAY OUCH. === : 

BETTER YET, IF CALLED BY A PANTHER, ==== 

DON'T ANTHER. ==== 

I...+....1.. ..+... .2. ...+.. ..3. ...+.. ..4. ...+.. ..5. ...+.. ..6. ...+.. ..7... 

THE CANARY === : 

THE SONG OF CANARIES ==== 

NEVER VARIES. ==== 

AND WHEN THEY'RE MOULTING ==== 

THEY'RE PRETTY REVOLTING. ==== 

THE GIRAFFE ==== 

====> SET CMDLINE TOP 

X E D I T 1 File 



U 

I) 
1"J 

n 
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3 
3 
3 
3 



TAILOR SCRIPT 

* * * Top of File * * * 
THE PANTHER 

THE PANTHER IS LIKE A LEOPARD, 
EXCEPT IT HASN'T BEEN PEPPERED. 
SHOULD YOU BEHOLD A PANTHER CROUCH, 
PREPARE TO SAY OUCH. 

BETTER YET, IF CALLED BY A PANTHER, 
DON'T ANTHER. 



+ 



Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 



THE CANARY 

THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 

I BEG YOU, CHILDREN, DO NOT LAUGH 
WHEN YOU SURVEY THE TALL GIRAFFE. 



Figure 33. The SET CMDLINE Subcommand - "Before" and "After' 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 
====> SET CURLINE ON 3 

* * * Top of File * * * ===== 

THE PANTHER ===== l 

THE PANTHER IS LIKE A LEOPARD, ===== [ 

EXCEPT IT HASN'T BEEN PEPPERED. ===== 

SHOULD YOU BEHOLD A PANTHER CROUCH , ===== p 

PREPARE TO SAY OUCH. ===== 1 

BETTER YET, IF CALLED BY A PANTHER, ===== 

DON'T ANTHER. ===== [ 

| ... + .... 1 . . .. + ... .2. ... + .. ..3. ... + .. . . 4 . ... + .. ..5. ... + .. . . 6 . ... + .. ..7... 

THE CANARY ===== [ 

THE SONG OF CANARIES ===== r 

NEVER VARIES. ===== I. 

AND WHEN THEY'RE MOULTING ===== 

THEY'RE PRETTY REVOLTING. ===== r 

THE GIRAFFE ===== 

I BEG YOU, CHILDREN, DO NOT LAUGH ===== 

WHEN YOU SURVEY THE TALL GIRAFFE. ===== .- 



TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 r- 

THE CANARY ===== r 

THE SONG OF CANARIES ===== 

NEVER VARIES. ===== [ 

AND WHEN THEY'RE MOULTING ===== 

THEY'RE PRETTY REVOLTING. ===== 



[ 



THE GIRAFFE 



| ... + .... 1 . . .. + ... .2. ... + .. ..3. ... + .. . . 4 . ... + .. ..5. ... + .. . . 6 . ... + .. ..7... l - 

I BEG YOU, CHILDREN, DO NOT LAUGH ===== 

WHEN YOU SURVEY THE TALL GIRAFFE. ===== [ 

IT'S HARDLY SPORTING TO ATTACK ===== 

A BEAST THAT CANNOT ANSWER BACK. ===== f 

HE HAS A TRUMPET FOR A THROAT, ===== [ 

AND CANNOT BLOW A SINGLE NOTE. ===== 

IT ISN'T THAT HIS VOICE HE HOARDS; ===== r 

HE HASN'T ANY VOCAL CORDS. ===== l - 

I WISH FOR HIM, AND FOR HIS WIFE, ===== 

A VOLUBLE GIRAFTER LIFE. ===== I 

* * * End of File * * * ===== 

r 

Figure 34. The SET CURLINE Subcommand - "Before" and "After" 

r 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 
====> SET SCALE OFF 

THE CANARY 

THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 



| . . . + 1 + 2 + 3. . . . + . 

I BEG YOU, CHILDREN, DO NOT LAUGH 

WHEN YOU SURVEY THE TALL GIRAFFE. 
"1 IT'S HARDLY SPORTING TO ATTACK 

A BEAST THAT CANNOT ANSWER BACK. 

HE HAS A TRUMPET FOR A THROAT, 
J AND CANNOT BLOW A SINGLE NOTE. 

IT ISN'T THAT HIS VOICE HE HOARDS; 

HE HASN'T ANY VOCAL CORDS. 

I WISH FOR HIM, AND FOR HIS WIFE, 

A VOLUBLE GIRAFTER LIFE. 

* * * End of File * * * 



TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 



J THE CANARY 



THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 

I BEG YOU, CHILDREN, DO NOT LAUGH 

WHEN YOU SURVEY THE TALL GIRAFFE. 

IT'S HARDLY SPORTING TO ATTACK 

A BEAST THAT CANNOT ANSWER BACK. 

HE HAS A TRUMPET FOR A THROAT, 

AND CANNOT BLOW A SINGLE NOTE. 

IT ISN'T THAT HIS VOICE HE HOARDS; 

HE HASN'T ANY VOCAL CORDS. 

I WISH FOR HIM, AND FOR HIS WIFE, 

A VOLUBLE GIRAFTER LIFE. 

* * * End of File * * * 



Figure 35. The SET SCALE Subcommand - "Before" and "After' 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line=9 Col=l Alt=0 
====> SET TABLINE ON 4 



THE CANARY 

THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 

I BEG YOU, CHILDREN, DO NOT LAUGH 

WHEN YOU SURVEY THE TALL GIRAFFE. 

IT'S HARDLY SPORTING TO ATTACK 

A BEAST THAT CANNOT ANSWER BACK. 

HE HAS A TRUMPET FOR A THROAT, 

AND CANNOT BLOW A SINGLE NOTE. 

IT ISN'T THAT HIS VOICE HE HOARDS; 

HE HASN'T ANY VOCAL CORDS. 

I WISH FOR HIM, AND FOR HIS WIFE, 

A VOLUBLE GIRAFTER LIFE. 

* * * End of File * * * 



TAILOR SCRIPT Al V 132 Trunc=132 Size-28 Line=9 Col=l Alt=0 

TTTTTTTTTTTTTTT 

THE CANARY ===== [ 

THE SONG OF CANARIES ===== f .. 

NEVER VARIES. ===== [ 

AND WHEN THEY'RE MOULTING ===== 

THEY'RE PRETTY REVOLTING. ===== r 

THE GIRAFFE ===== 

I BEG YOU, CHILDREN, DO NOT LAUGH ===== 

WHEN YOU SURVEY THE TALL GIRAFFE. ===== 

IT'S HARDLY SPORTING TO ATTACK ===== [ 

A BEAST THAT CANNOT ANSWER BACK. ===== 

HE HAS A TRUMPET FOR A THROAT, ===== r 

AND CANNOT BLOW A SINGLE NOTE. ===== I 

IT ISN'T THAT HIS VOICE HE HOARDS; ===== 

HE HASN'T ANY VOCAL CORDS. ===== [ 

I WISH FOR HIM, AND FOR HIS WIFE, ===== 

A VOLUBLE GIRAFTER LIFE. ===== , 

* * * End of File * * * ===== [. 

Figure 36. The SET TABLINE Subcommand - "Before" and "After" 
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TAILOR SCRIPT Al V 132 Trunc=132 Size=28 Line-9 Col=l Alt= 
====> SET MSGLINE ON 3 15 OVERLAY 

rpmmmmmmmmmmmmr 

THE CANARY 

THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 



I BEG YOU, CHILDREN, DO NOT LAUGH 

WHEN YOU SURVEY THE TALL GIRAFFE. 
-] IT'S HARDLY SPORTING TO ATTACK 

-J A BEAST THAT CANNOT ANSWER BACK. 

HE HAS A TRUMPET FOR A THROAT, 
~1 AND CANNOT BLOW A SINGLE NOTE. 

IT ISN'T THAT HIS VOICE HE HOARDS; 

HE HASN'T ANY VOCAL CORDS. 

I WISH FOR HIM, AND FOR HIS WIFE, 

A VOLUBLE GIRAFTER LIFE. 

* * * End of File * * * 



TAILOR SCRIPT Al V 132 Trunc=132 Size-28 Line=9 Col=l Alt=0 
====> QUERY COLOR * 



1 TTTTTTTTTTTTTTT 

THE CANARY 

_J THE SONG OF CANARIES 

NEVER VARIES. 
— i AND WHEN THEY'RE MOULTING 

-J THEY'RE PRETTY REVOLTING. 



THE GIRAFFE 

I BEG YOU, CHILDREN, DO NOT LAUGH 

WHEN YOU SURVEY THE TALL GIRAFFE. 

IT'S HARDLY SPORTING TO ATTACK 

A BEAST THAT CANNOT ANSWER BACK. 

HE HAS A TRUMPET FOR A THROAT, 

AND CANNOT BLOW A SINGLE NOTE. 

IT ISN'T THAT HIS VOICE HE HOARDS; 

HE HASN'T ANY VOCAL CORDS. 

I WISH FOR HIM, AND FOR HIS WIFE, 

A VOLUBLE GIRAFTER LIFE. 

* * * End of File * * * 



Figure 37 (Part 1 of 2). SET MSGLINE on Multiple Lines with Overlay 
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PENDING 
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NONE 
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PSO 


COLOR 


PREFIX 
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NONE 
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SCALE 
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PSO 


COLOR 


SHADOW 


DEFAULT 


NONE 


NOHIGH 


PSO 


COLOR 


STATAREA 


DEFAULT 


NONE 


HIGH 


PSO 


COLOR 


TABLINE 


DEFAULT 


NONE 


HIGH 


PSO 


COLOR 


TOFEOF 


DEFAULT 


NONE 


NOHIGH 


PSO 


THE CANARY 











THE SONG OF CANARIES 
NEVER VARIES. 
AND WHEN THEY'RE MOULTING 
THEY'RE PRETTY REVOLTING. 

THE GIRAFFE 



Figure 37 (Part 2 of 2). SET MSGLINE on Multiple Lines with Overlay 
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The macro language is one of the most powerful facilities that the editor 
provides. By writing macros, you can: 

• Expand the basic subcommand language 

o Expand the prefix subcommand language 

- , • Tailor the language to your own application 

- -. o Eliminate repetitive tasks. 

~ , This chapter explains how to write an XEDIT macro, discusses those XEDIT 

— ' subcommands designed for use in macros, describes an XEDIT macro 

--. written for a text processing application, explains a profile macro, and 

explains how to write prefix macros. You should be familiar with the 

--, Restructured Extended Executor (REXX) language, which is described in 

-J the publications VMjSP System Product Interpreter User's Guide and 

- i VM/SP System Product Interpreter Reference before you read this chapter. 

What Is an XEDIT Macro? 

I] 

-, An XEDIT macro is a REXX file that is invoked from the XEDIT 

— J environment. 

—J (A macro may also be written using the EXEC 2 language. However, all 

— I examples in this chapter are based on the REXX language.) 

— j You execute a macro the same way you execute XEDIT subcommands; type 

— J the macro name on the command line (or the prefix area) and press the 

--, ENTER key. A macro may be executed by entering only its name (or 

- J synonym), or its execution may also depend on arguments you enter when 

— -j the macro is invoked. 

— t A macro file can contain: 

—i • XEDIT subcommands 

- J i'" • REXX instructions 

-i V • CMS and CP commands. 
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Creating a Macro File 



Because an XEDIT macro is a normal CMS file, it may be created in any of 
the ways that CMS provides for file creation. It can even be created 
dynamically, by using the XEDIT multiple file editing capability (see 
"Chapter 5. Editing Multiple Files"). As soon as a FILE subcommand is 
executed for the macro file, the macro can be used. 

Like any CMS file, a macro file is identified by filename, filetype, and 
filemode. The file identifier for a macro file must follow certain rules: 

© For macros entered from the command line, the filename is a string of 
one to eight alphameric characters. This name is used to invoke the 
macro. For example, if the filename is SEND, entering "SEND" during 
an editing session causes the macro to be executed. (For information on 
the search order and handling filenames that contain numbers, see 
"Avoiding Name Conflicts" later in this chapter.) 

Prefix macro filenames may be one to eight characters, but they may 
not contain numbers. (Because the prefix area is only five positions 
long, you can define a synonym for a prefix macro filename that is 
longer than five characters. For more information on defining 
synonyms for prefix macros, see "Writing Prefix Macros," later in this 
chapter, and the SET PREFIX subcommand description in the VM/SP 
System Product Editor Command and Macro Reference.) 

o The filetype must be XEDIT. 

• The filemode can specify any of your accessed disks, for example, Al. 



Usinq XEDIT Subcommands in a Macro 



A macro can contain any XEDIT subcommand, with the following [ 

exceptions: prefix macros cannot contain READ, QUIT, FILE, SET 

RANGE, SORT, and LPREFIX. However, some subcommands perform [ 

functions that are meaningful only in the context of a macro, for example, 

one that passes information to the System Product Interpreter. [ 

The following list summarizes these subcommands; some are then discussed [ 

according to function. For detailed information on all of these 

subcommands, refer to the publication VM/SP System Product Editor [ 

Command and Macro Reference. 

CMS RESTORE 

CMSG SET CTLCHAR r 

i 
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COMMAND 

CP 

CURSOR 

EMSG 

EXTRACT 

MACRO 

MSG 

PRESERVE 

READ 



SET COLOR 
SET DISPLAY 
SET MSGLINE 
SET MSGMODE 
SET PENDING 
SET RESERVED 
SET SCOPE 
SET SELECT 
STACK 






I] 



Communicating between the Editor and the Interpreter 

The following subcommands are discussed in this section: 

READ 
EXTRACT 

Both READ and EXTRACT can supply a macro with information. 

The READ subcommand is used to find out what the user has entered on 
the screen. It places fields that have been changed on the screen in the 
console stack. Once something is in the console stack, it cannot be used by 
the macro until it has been taken out of the console stack. The REXX PULL 
instruction is used to take information out of the console stack and assign 
it to program variables, which can then be examined by the macro. 

The EXTRACT subcommand can supply a macro with information about 
internal XEDIT variables or about file data. The information is returned in 
one or more variables, which can then be examined or used by the macro. 

The following sections provide examples of using READ and EXTRACT. 



READ Subcommand 



u 



u 



When a READ subcommand is issued from a macro, the editor displays 
"Macro-read" in the status area of the user's screen and waits for the user 
to enter data and/or press a key. (The file image remains on the screen.) 
After a key is pressed, the data is placed in the console stack. 

Operands of the READ subcommand can be used to specify how much 
information is placed in the console stack. The READ subcommand can be 
used to place either the command line or all changed lines in the console 
stack. In addition, you can request that a tag identifying the origin of the 
line(s) be inserted at the beginning of each line stacked. 

A subsequent REXX PULL instruction assigns the data to program 
variable(s), and the macro continues executing. 

The READ subcommand has the following format: 



v. 
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READ 



Cmdline Tag | Notaq 
All Number Tag | Notaq 
Nochange Number Tag | Notag 



Where: 

Cmdline 

only the command line is stacked. 



All 



anything changed on the screen is stacked. 



Nochange 

same as ALL, but the copy of the file in storage is not updated. 

Number 

changed file lines are prefixed by their line numbers. 



Tag 



tags that identify the origin of changed lines precede lines placed in 
the stack. 



Notag 

no tags are stacked. 

Normally, a macro displays a message requesting that you enter data on the 
command line before it issues a READ. 

For example: 

MSG ENTER FILENAME FILETYPE FILEMODE 

("ENTER FILENAME FILETYPE FILEMODE" is displayed.) 

READ CMDLINE 

(User enters MYFILE SCRIPT A in the command line and READ puts 
it in the console stack.) 

DTTT T TflVT T?HP T?T\/T 

(Takes the fileid out of the stack and assigns MYFILE, SCRIPT, and A 
to FN, FT, and FM, respectively.) 



The EXTRACT Subcommand 



The EXTRACT subcommand returns information about editing options 
(options defined by the SET subcommand) as well as other file data that is 
not explicitly "set." The information is returned as one or more variables in 
the form "name.n", where "name" is the same as the variable requested and 
"n" is a subscript that distinguishes the different values returned for each 
option requested. 
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For example, if a macro wants information ajboutthe case setting it can 
"2 issue: 



EXTRACT /CASE/ 

This returns information about the contents of the case setting in the 
following variables: 



J 

J CASE . number of variables returned 

CASE.l MIXED | UPPER 

~] CASE. 2 RESPECT | IGNORE 

2] The macro could use this information as follows: 



msg "The current case setting is" case.l case. 2 



J Displaying Data on the Editor's Screen 

-J The following subcommands are discussed in this section: 



MSG 

EMSG 

CMSG 

SET MSGMODE 

SET RESERVED 

SET CTLCHAR 

CURSOR 



MSG, EMSG, and CMSG Subcommands 



A macro can communicate with the user by displaying messages in the 
message line of the screen. Messages are used for various reasons, for 
example, requesting the user to enter data, telling a user that an error has 
occurred during processing, and so forth. 

The following two subcommands display a message in the message line of 
the screen: 

MSG 

displays a message in the message line. 

EMSG 

displays a message in the message line and sounds the alarm. 

For example: 

MSG ENTER FILE NAME 

Displays "ENTER FILE NAME" in the message line. 

EMSG MISSING OPERANDS 

Displays "MISSING OPERANDS" in the message line and sounds the 
alarm. 
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Note: REXX also provides an instruction, SAY, that displays one line of 
data at the terminal. However, the SAY instruction causes the screen to be 
cleared before the data is displayed. 

The XEDIT subcommands MSG and EMSG keep the file image on the 
screen and display the data in the message line. Therefore, you should use 
them instead of SAY in a macro. 

The following subcommand displays a message in the command line of the 
screen: 

CMSG 

When issued from a macro, the CMSG subcommand can be used to 
redisplay input that the user has entered incorrectly, so that it can be 
corrected and reentered. 



SET MSGMODE Subcommand 



The SET MSGMODE subcommand is used to control whether or not 
messages are displayed: 

SET MSGMODE ON All messages are displayed. 
SET MSGMODE OFF No messages are displayed. 

By turning the message mode on and off during a macro, you can select 
when you want messages to be displayed. 



SET RESERVED Subcommand 



When issued from a macro, the SET RESERVED subcommand reserves a 
specified line on the screen for use by the macro, thereby preventing the 
editor from using that line. The line can be used for displaying blank or 
specified information, which can optionally be displayed in various ways for 
emphasis. For example, depending on the features supported by your 
terminal, the line can be displayed highlighted, using a programmed symbol 
set, in various colors, or with extended highlighting features (blinking, 
reverse video, or underlining). 

For example, the following subcommand: 

SET RESERVED 10 HIGH YOU CAN'T USE THIS LINE. 

displays, on the tenth line of the screen, "You can't use this line." The line 
is highlighted. 

Another example of SET RESERVED is shown with SET CTLCHAR, 
discussed below. 
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SET CTLCHAR Subcommand 
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The SET CTLCHAR subcommand is used to specify attributes for fields 
within a reserved line. Depending on the features supported by your 
terminal, these fields may be displayed highlighted, protected, invisible, in 
various colors, using different programmed symbol sets, or with extended 
highlighting features (blinking, reverse video, or underlining). 

In the following example, note how SET RESERVED and SET CTLCHAR 
are used to control exactly how the reserved lines are displayed. 



/* This XEDIT macro will show examples of using SET CTLCHAR */ 

'SET CTLCHAR % ESCAPE 1 

'SET CTLCHAR + PROTECT BLUE REVVIDEO NOHIGH ' 

'SET CTLCHAR J NOPROTECT GREEN UNDERLINE NOHIGH' 

'SET RESERVED 3 YEL HIGH This is Yellow%+And this is Blue and Reversed.' 

'SET RESERVED 5 RED BLINK NOH Red and Blinking% JGreen and Underlined.' 



CURSOR Subcommand 



The CURSOR subcommand can be used to move the cursor to a specified 
position on the screen, and optionally, to assign a priority to that position. 
For example, the editor has a macro called SCHANGE, which looks for a 
string and moves the cursor under the string if it is found. For an example 
of using the CURSOR subcommand, see "Positioning the Cursor," later in 
this chapter. 



Saving and Restoring Editing Variables 



3 



The PRESERVE subcommand is used to save the settings of various editing 
variables until a subsequent RESTORE subcommand is issued. For 
example, you might want to preserve a setting so that you can change it for 
the duration of the macro, and restore it before the macro finishes 
executing. For a complete list of the variables affected, refer to the 
PRESERVE subcommand description in the publication VM/SP System 
Product Editor Command and Macro Reference. 



Issuing CMS and CP Commands 



zi 



As you have seen, an XEDIT macro can contain XEDIT subcommands, 
REXX instructions, and CMS and CP commands. CMS and CP commands 
can be issued as operands of the XEDIT subcommands CMS and CP, 
respectively. 

For example: 

CMS ERASE FILEA SCRIPT 
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(CMS and CP commands can also be issued by using the REXX 
instructions, ADDRESS CMS or ADDRESS COMMAND.) 

Avoiding Name Conflicts 

The following subcommands are discussed in this section: 

COMMAND 
MACRO 
SET MACRO 
SET SYNONYM 

Use the COMMAND subcommand to cause the editor to execute a specified 
subcommand without first checking to see if a synonym or macro with the 
same name exists. This subcommand overrides SET SYNONYM ON or SET 
MACRO ON (discussed below). 

For example: 

COMMAND PRESERVE 

executes the PRESERVE subcommand, even if a synonym or macro with 
the same name exists. 

Similarly, use the MACRO subcommand to cause the editor to execute a 
specified macro without first checking to see if a subcommand of the same 
name or a synonym exists. (Of course, this cannot be used for prefix 
macros.) 

The MACRO subcommand can also be used to avoid name conflicts, in the 
following manner. When a subcommand has a number as its operand, a 
blank is not required between the subcommand name and the operand. For 
example, both "NEXT8" and "N8" are interpreted by the editor as being the 
subcommand "NEXT 8". Therefore, if a macro name were also "N8," the 
macro would not be executed; the subcommand "NEXT 8" would be 
executed instead. To execute the macro, you could enter the following: 

MACRO N8 

The macro whose name is "N8" would then be executed. 

The SET MACRO subcommand can be used to control the order in which 
the editor searches for subcommands and macros. SET MACRO ON tells 
the editor to look for macros before it looks for subcommands; SET MACRO 
OFF reverses the order. 

In addition, SET SYNONYM can be used to specify whether or not the 
editor looks for synonyms. 
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Walking through an XEDIT Macro 



" ] The following XEDIT macro is an example of the type of macro you might 

write to make life a little easier. The application is typical of a text 

""] processing file arrangement, where many SCRIPT files are imbedded in a 

master file, via the SCRIPT control word ".im". 

_J 

The problem with this type of setup is that if you have to make a global 

^J change throughout all the files, you have to edit each file, make the 

change, and then file each file. 

J 



When issued from the master file, this macro edits each file, performs a 
global change, and files it. 



'2] The macro is invoked by entering the macro name, GLOBCHG; the 

arguments passed to the macro are the old data and the new data, enclosed 
_] in delimiters: 



GLOBCHG /stringl/string2/ 



- 1 For example, if a file called MASTER SCRIPT contains: 

.im FILE1 
_J .im FILE2 



.im FILE100 

and the following commands are issued: 

XEDIT MASTER SCRIPT 

GLOBCHG/WAR AND PEACE/SENSE AND NONSENSE/ 

"WAR AND PEACE" is changed to "SENSE AND NONSENSE" each time 
~] it occurs in every file. (In this macro, no attempt is made to execute the 

change on files that may be imbedded at the next level.) 

The GLOBCHG macro can also be used to delete data throughout the files, 
'"] by changing a string to a null string, for example: 

-, GLOBCHG /bad data// 



The following is a listing of the macro, whose fileid is GLOBCHG XEDIT 
Al. After the listing, each line in the macro is explained. For more 
information on the System Product Interpreter statements used in the 
macro, see the publication VMjSP System Product Interpreter Reference. 
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00001 


/* Do a global change on imbedded Script f. 


Lies 


*/ 


00002 


/* Input to this macro is the CHANGE 


command to be executed on 


*/ 


00003 


/* the file currently being xedited and 


on 


any files it imbeds. 


*/ 


00004 


parse arg operand 




/* 


Get passed CHANGE cmd 


V 


00005 


if operand = ' ' then do 




/* 


If omitted, then error 


*/ 


00006 


emsg 'EXE545E Missing operand(s)' 




/* 


Give error message 


V 


00007 


parse source . . me . 




/* 


Get this macros name 


*/ 


00008 


cmsg me 




/* 


Put it on command line 


V 


00009 


exit 




/* 


Leave this macro 


*/ 


00010 


end 




/* 


End of DO loop 


V 


00011 


preserve 




/* 


Save current status 


V 


00012 


set wrap off 




/* 


Set wrap off 


*/ 


00013 


set msgmode on 




/* 


Set message mode on 


V 


00014 


set case mixed ignore 




/* 


Set proper case 


V 


00015 


top 




/* 


Go to TOP of file 


*/ 


00016 


find . im 




/* 


Find first imbed file 


V 


00017 


if re -i= then do 




/* 


If none found, give msg 


*/ 


00018 


restore 




/* 


Restore previous status 


*/ 


00019 


emsg 'No IMBED found. ' 




/* 


Give message 


*/ 


00020 


exit 




/* 


Leave this macro 


V 


00021 


end 




/* 


End of DO loop 


V 


00022 


do while rc=0 




/* 


Imbed found, process it 


V 


00023 


extract '/ cur li ne /' 




/* 


Get current line 


V 


00024 


parse upper var cur line. 3 . fname . 




/* 


Separate out file name 


*/ 


00025 


address command state fname "SCRIPT 


* 


• /* 


Does this file exist? 


*/ 


00026 


if re -i= then do 




/* 


If not, issue message 


V 


00027 


msg 'IMBEDed file' fname 'SCRIPT 


do 


es not exist, bypassed. 1 




00028 


find . im 




/* 


Search for next imbed 


V 


00029 


iterate 




/* 


Cause next loop iterat'n*/ 


00030 


end 




/* 


End of inner DO loop 


V 


00031 


xedit fname 'SCRIPT (NOPROFILE 1 




/* 


File exists, XEDIT it 


V 


00032 


extract ' /f name/f type/fmode/' 




/* 


Get name, type, mode 


V 


00033 


msg 'Processing file' fname. 1 ftype 


.1 


fmode.l /* Issue message 


*/ 


00034 


change operand ' * * ' 




/* 


Issue CHANGE command 


V 


00035 


file 




/* 


Save the file & quit 


V 


00036 


find . im 




/* 


Find the next imbed 


*/ 


00037 


end 




/* 


End of outer DO loop 


*/ 


00038 


restore 




/* 


Loop ends, restore 


V 


00039 


msg 'No more .imbeds found, global ch 


an 


ge completed. ' /* Give msg 


*/ 


00040 


exit 




/* 


All done, leave macro 


V 



Figure 38. A Sample Macro 

Now, let's walk through the macro, a line at a time. 

00001 /* Do a global change on imbedded Script files */ 

System Product Interpreter comment line. This is a required line and 
tells the Interpreter this is a REXX file. 

00004 parse arg operand 

Place the passed arguments into the variable called OPERAND. 

00005 if operand = " then do 

If no arguments were entered when the macro was invoked, execute 
the following statements until an END is reached (DO loop). 
(OPERAND was set to a null in line 4.) 



146 VM/SP System Product Editor User's Guide 



^ 



^^ 1 



00006 emsg 'EXE545E Missing operand(s)' 

] Display this message. 



j 00007 parse source . . me . 

Look at the source string and place the name of this macro into the 
" j variable ME. 

'_] 00008 cmsg me 

The macro name (in the variable ME) is displayed on the command 
J line. 

J 00009 exit 

Return control to the editor. 

:j 

00010 end 

J This statement signals the end of the DO loop that began in line 5. 

'_] 00011 preserve 

This subcommand saves the editor settings until a subsequent 
1J RESTORE subcommand is issued (line 37). 

~_j | 00012 set wrap off 

| Wrapping during the target search is turned off. When the end of the 

_J | master file is reached the macro will end, rather than wrapping 

| around, searching for ".im," and getting caught in a loop. 

00013 set msgmode on 

J Messages will be displayed. By turning the message mode on and off, 

you can select which messages you want displayed. 

00014 set case mixed ignore 

_J In target searches, uppercase and lowercase representations of the 

same letter will match. 
"J 

00015 top 

_J Move the line pointer to the top of the master file, which is the file 

from which the macro was invoked. 
I] 

00016 find .im 

_J Search forward in the master file for the first line that contains ".im" 

in column 1, that is, locate the first line that imbeds a file. 

00017 if re -i = then do 

_J If there is a non-zero return code from the FIND subcommand 

(previous statement), then do the following statements up to the END 
—J (another DO loop). 

00018 restore 

Restore the settings of XEDIT variables to the values they had when 
the PRESERVE subcommand was issued (line 11). 
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00019 emsg 'No IMBED found.' 

Display this message. 

00020 exit 

Return control to the editor. 

r 

00021 end 

This statement signals the end of the DO loop that was started in line [ 

16. 

i 

00022 do while rc = 

Repeat the following statements (up to the END in line 36), as long as [ 

the return code (RC) is 0. The initial value for RC is set by the FIND 

subcommand in line 15; we reach this point only if RC was set to 0, [ 

which means an imbedded file was found. The last statement in this 

loop is also a FIND subcommand, and RC will be reset to the return [ 

code for that FIND subcommand just before we return to this point to 

execute the statements again. When the return code is not 0, this [ 

macro will continue with the statement following the END (line 36). 

i 

00023 extract Vcurline/' 

Return information about the current line in macro variables, in the l 

form "curline.n," where the subscript distinguishes among the 

variables. 

00024 parse upper var curline.3 . fname . , 
CURLINE.3 contains the contents of the current line (as returned by 

the EXTRACT subcommand above). In this case the current line is I 

the .im statement that was found via a "find .im". This statement 
takes the second blank delimited word from the variable CURLINE.3 [ 

and puts it into the variable FNAME. 

r 

00025 address command state fname 'SCRIPT *' 

The STATE command is a CMS command that verifies the existence of I. 

a file. This statement checks to see if the file named in the .im 

statement exists. The quotes are needed around the asterisk to avoid \. 

confusion with the REXX multiplication operator. Enclosing the word 

SCRIPT and the asterisk in quotation marks makes it a literal string. 1 

00026 if re -i = then do [ 

If the return code from the STATE command is not zero, then do the 

following statements up to the END statement in line 29 (DO loop). I 

00027 msg 'IMBEDed file' fname 'SCRIPT does not exist, bypassed.' f 

Display this message. REXX will substitute the value of "fname" in 
the message before it is displayed. 



r 



00028 find .im L 

This locates the next imbed control word in the file. 
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00029 iterate 

This statement tells REXX to go to the END statement and complete 
the processing for this iteration of the DO loop. 



00030 end 

"] This statement signals the end of the DO loop that was started in line 

25 above. 
"'1 

00031 xedit fname 'SCRIPT (NOPROFILE' 

"J This statement will invoke the editor (XEDIT) for the file specified. 

REXX will substitute the value of "fname" in this line before passing 
"] it to XEDIT. 

"j 00032 extract '/fname/ftype/fmode/' 

Returns the filename, filetype, and filemode in macro variables. 

J 

00033 msg 'Processing file' fname. 1 ftype.l fmode.l 

~J\ Displays the message, with the file identification as returned by 

EXTRACT. 

"J 

00034 change operand '* *' 

_] The global change is executed. OPERAND contains the arguments 

entered when the macro was invoked (see line 4). 

:j 

00035 file 

2] The changed file is written to disk. 

Z) 00036 find .im 

The editor resumes editing the master file, searching for the next ".im 
_j filename" statement. 

I] 00037 end 

This statement signals the end of the DO loop that was started in line 

I] 21. 

I) 00038 restore 

Restore the settings of XEDIT variables to the values they had when 
_] the PRESERVE subcommand was issued (line 11). 

1 00039 msg 'No more .imbeds found, global change completed.' 

_ Display this message. 

00040 exit 

Return control to the editor. You can then issue a QUIT subcommand 
for the master file. 
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A Profile Macro for Editing 



As a CMS user, you are familiar with a PROFILE EXEC macro, which 
contains the CMS and CP commands you normally issue at the start of a 
terminal session and is executed automatically after you issue the IPL CMS 
command. 

The editor offers a similar profile capability with a PROFILE XEDIT macro, 
which contains XEDIT subcommands that tailor each editing session to suit 
your needs and is executed automatically after you issue an XEDIT 
command (or subcommand). 



Executing a Profile Macro 



The filetype of a profile macro must be "XEDIT". If the fileid is PROFILE 
XEDIT, the macro is executed automatically when an XEDIT command (or 
subcommand) is issued. You can write a PROFILE XEDIT macro, file it, 
and forget about it. It will be executed before each file is brought into 
storage. 

If you do not want a PROFILE XEDIT macro to be executed for a particular 
editing session, you can issue the following XEDIT command: 

XEDIT fn ft (NOPROFILE 

The PROFILE XEDIT macro is bypassed, and the file is brought into 
storage. 

Although the filetype of a profile macro must be "XEDIT," the filename 
does not have to be "PROFILE". If your profile macro has a name other 
than "PROFILE," you must indicate its filename in the PROFILE option of 
the XEDIT command. 

For example, if the fileid is MYPROF XEDIT, you must issue the following 
XEDIT command: 

XEDIT fn ft (PROFILE MYPROF 



r 



The macro labelled MYPROF XEDIT is executed, even if a macro labelled I 

PROFILE XEDIT exists. 

Writing a Profile Macro [ 

A profile macro can be as simple or complex as you wish. Like any macro, [ 

it can contain System Product Interpreter statements, CMS and CP 

commands, and any XEDIT subcommands or macros. It usually contains [ 

one or more SET subcommands that create an editing environment to your 

liking. / \ 
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It can also contain a LOAD subcommand, which can be issued only from a 
'] profile macro. When the profile macro begins execution, a copy of the file 

^ has not yet been brought into virtual storage. Therefore, a LOAD 

"| subcommand, which has the same format and options as the XEDIT 

command, can be used to supply editing options that are not specified in the 
j XEDIT command itself. 

"J Within the profile macro, the LOAD subcommand must be the first XEDIT 

subcommand. If it is not, a LOAD subcommand is automatically issued by 

"] the editor; its operands are the same as those issued in the XEDIT 

command. (System Product Interpreter statements and CMS commands can 

" 1 be issued before the LOAD.) 

~ 1 The profile macro can be used to prompt the user for XEDIT command 

options or to assign values to editing variables before issuing the LOAD 

J subcommand. For example, a SCRIPT user might program his profile to use 

a LOAD subcommand that does defaulting of filetype. 

The options specified in the LOAD subcommand have a lower priority than 
^J those specified in an XEDIT command. For example, an UPDATE option 

specified in the LOAD subcommand would be overridden by a NOUPDATE 
] option specified in the XEDIT command. 

_J When the LOAD subcommand is executed, the file is brought into virtual 

storage. 

I] '- 

If the LOAD fails, a non-zero return code is generated. All subsequent 

_] subcommands in the profile macro are rejected with a unique "6" return 

code. 

3 

For detailed information on the LOAD subcommand, refer to the 
_] publication VM/SP System Product Editor Command and Macro Reference. 

~ An Example of a Profile Macro 

An example of a profile macro is shown in Figure 39. 

:.] 

D 
3 

3 
::i 

3 

3 r 

3 v 
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00001 


/* Sample XEDIT profile 






*/ 


00002 


parse arg f n f t ' ( ' options 


/* 


put arguments into variables 


*/ 


00003 


if ft= ' ' then ft= 'SCRIPT' 


/* 


if no filetype, use SCRIPT 


V 


00004 


load fn f t ' ( ' options 


/* 


issue LOAD statement 


*/ 


00005 


set tabline on 22 


/* 


put tab line on line 22 


*/ 


00006 


set scale on 22 


/* 


put scale on line 22 


V 


00007 


set fullread on 


/* 


full-screen read on 


V 


00008 


set nulls on 


/* 


end of line nulls on 


*/ 


00009 


set number on 


/* 


line numbers to be used 


*/ 


00010 


set pflO save 


/* 


PF10 to SAVE 


V 


00011 


set synonym fiel 4 file 


/* 


when my fingers don't work 


*/ 


00012 


exit 


/* 


exit this macro 


V 



Figure 39. A PROFILE XEDIT Macro 



00001 /* Sample XEDIT profile */ 

Identifies the macro as a System Product Interpreter file. 

00002 parse arg fn ft '('options 

Puts argument into variables. 

00003 if ft= " then ft= 'SCRIPT' 

If there is no filetype assigned, this will assign a filetype of SCRIPT. 



00004 load fn ft '(' options 

Loads the file. 



00005 set tabline on 22 

Sets the tabline on line 22 of the screen. 

00006 set scale on 22 

Superimposes the scale on line 22 of the screen. 



00007 set fullread on 

Sets the full-screen read on to allow recognition by XEDIT of 3270 
null characters in the middle of the screen lines. 

00008 set nulls on 

Sets NULLS ON to replace all trailing blanks with nulls. 

00009 set number on 

Sets NUMBER ON to assign a line number to each line in the file. 

00010 set pflO save 

Sets PF10 to save the file. 

00011 set synonym fiel 4 file 

Sets a synonym "fiel" for the subcommand "file". 

00012 exit 
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Exit the macro. 



] Writing Prefix Macros 

You can write prefix macros for a variety of purposes, from performing a 
H function from the prefix area that is normally accomplished by entering a 

subcommand on the command line, to creating an entirely new function. 

You must be familiar with the REXX language before reading this section. 
"I More information on REXX can be found in the publications cited at the 

beginning of this chapter. 

J 

J Creating a Sample Prefix Macro 

The U prefix macro gives the user the ability to translate one or more lines 
-I in a file to uppercase, which normally is accomplished by issuing the 

UPPERCAS subcommand in the command line. When U is entered in the 
~ | prefix area of a line, that line is translated to uppercase. A number may be 

specified before or after the U to translate more than one line; for example, 
1 3U= = = or =U5==. 

~] The file is created with the XEDIT command: 

XEDIT U XEDIT 

- , The U prefix macro looks like this: 



00001 


/* This macro translates a line(s) 


to uppercase. 


*/ 


00002 


arg . . pline op . 






00003 


If op = ' ' then op = 1 






00004 


'COMMAND : 'pline 'UPPERCAS' op 






00005 


Exit 







-J 
;j 
~j 
-j 

What Information is Passed to the Macro? 

—j An argument string is automatically passed to a prefix macro when it is 

invoked. It can supply a macro with information critical to its execution, 



J 



like the line number of the prefix area in which the macro was entered. 



— I Line 2 (above) is a REXX statement that parses (splits up) the string, 

according to the template shown. (The argument string is described in 

-i greater detail later in this chapter.) Pline represents the line number of the 

' prefix area, and op represents the optional operand. These variable names 

-■] V. - provide the macro with answers to the following questions: 
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On which line was the macro entered? 

How many lines are to be translated to uppercase? 

Line 3 determines if an operand was entered. If the operand is null, a 
default of 1 is assumed. 

Line 4 makes the line in which the prefix macro was entered (pline) the new 
current line and then issues the UPPERCAS subcommand, with the 
operand. 



Current Line Positioning 



Note that in line 4, :pline is an absolute line number target. It is used to 
make the prefix line (pline) current for the UPPERCAS subcommand, which 
operates on the current line. 

After the pending list is finished executing, the current line is returned 
automatically to the line that was current when it began execution. 
Therefore, even though pline is made current for the UPPERCAS 
subcommand, the macro need not restore the current line. 

For information on overriding this automatic current line return, see the 
SET PENDING subcommand in the VM/SP System Product Editor 
Command and Macro Reference. 



Creating a Second Prefix Macro 



Let's create another prefix macro called L, which gives the user the ability 
to translate one or more lines in a file to lowercase, which normally is 
accomplished by issuing the LOWERCAS subcommand in the command 
line. This macro is similar in function to the U macro described above; 
however, we will give the user the additional ability of specifying a block of 
lines to be translated, by entering LL on both the first and last lines of the 
block. 



This macro is presented in segments, to illustrate various concepts, 
entire macro is shown at the end of this chapter. 



The 



Examining the Source String 



You have already seen that an argument string is passed to a prefix macro 
when it is invoked. A source string is also passed. 



00007 parse source name , 

00008 arg pref func pline op extra 
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Line 7 parses the source string according to the template shown. In this 
example, we're using the source string to get the name of the prefix macro 
as the user entered it (without operands). Later, you will see how the 
macro uses name to determine if it was invoked in its simple form (L) or 
block form (LL). 

The source string is described in detail in the VMjSP System Product 
Interpreter Reference, under "Parse Source." 

In line 8, the argument string is parsed. For now, note that pline is the line 
number of the prefix area, and op is the optional operand. 



J 

u 



The rest of the argument string is described later in this chapter, under 
"Examining the Argument String." 

In this example, if L8 were entered in the prefix area of line 3 of a file, 
name would be L, pline would be 5, and op would be 8. 



Using the Information That Is Passed 



U 
J 
J 
J 
J 
J 



The following part of the macro shows how some of the information derived 
from the strings is used. 



00007 


P 






00008 


arg 


pref func pline op extra 




00019 


• 




when length ( name ) =1 then do 




00020 






If op = ' ' then op = 1 




00021 






If datatype (op , 'W ) then, 




00022 






'COMMAND : 'pline ' LOWERCAS ' op 




00023 






else call error "Invalid operand :" 


op 


00024 






end 





u 
I] 
u 



In lines 19 through 24, you can see that the source and argument strings 
supply the answers to these questions: 

What name was used to invoke the macro? 

On which line was it entered? 

How many lines are to be changed to lowercase? 



Using the variable names assigned in the templates, lines 19 through 24 
perform the following functions: 



3 



1. See if the macro was entered in its simple form (L). When the length of 
name is one, the macro was entered in its simple form. 

2. If no operand was entered, assign a default of 1 or determine if the 
operand (if any) is a valid whole number (lines 20 and 21). Otherwise, 
go to an error routine (line 23). 
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3. Make the line in which the prefix macro was entered (pline) current 
and issue the LOWERCAS subcommand, with the operand (line 22). 



Handling Blocks 



A block is a group of consecutive lines. Several XEDIT prefix 
subcommands and macros (for example, D and > ) allow you to specify 
blocks by doubling the name and entering it on both the first and last lines 
of the block (for example, DD entered on the first and last lines of a block 
deletes the entire block of lines). Let's expand the L prefix macro to accept 
blocks (specified by entering LL on the first and last lines of the block). 

This section explains the following: 

• How to assign a synonym for a prefix macro 



o How to examine the pending list of prefix subcommands and macros for 
a matching block entry 

• How to display a pending notice in the status area of the screen. 



00018 


select 


00019 


when 


00020 


I 


00021 


I 


00022 




00023 


e 


00024 


e 


00025 




00026 


when 


00027 


I 


00028 




00029 


1 


00030 


i 


00031 




00032 




00033 




00034 


e 


00035 


E 



length ( name ) =1 then do 
f op = ' ' then op = 1 
f datatype (op, 'W' ) then, 

•COMMAND : 'pline 'LOWERCAS' op 
lse call error "Invalid operand :" op 
nd 

length (name) =2 then do 

f op ~i= ' ' then call error, 
' Invalid operand : ' op 

COMMAND EXTRACT /PENDING BLOCK' name ':0 : 'pline '/' 

f pending. 0-i=0 then do 

^ COMMAND :' pending. 1 'SET PENDING OFF' 
'COMMAND : 'pending. 1 "LOWERCAS : 'pline+1 
end 

lse 'COMMAND : 'pline 'COMMAND SET PENDING BLOCK' name 

nd 



Assigning a Synonym for a Prefix Macro 



The user must issue the following subcommand in order to be able to 
specify the block form of the L macro. You can enter this subcommand in 
the PROFILE XEDIT file: 

SET PREFIX SYNONYM LL L 

Now, the user can invoke the L prefix macro by entering either L (with an 
optional numeric operand) or LL. In line 19, the macro checks for its 
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simple form (when the length of name is 1). In line 26, the macro checks for 
its block form (when the length of name is 2). 

Synonyms can also be assigned for other reasons. For example: 

o A prefix macro filename can be up to eight alphabetic characters long, 
but the prefix area is only five positions long. You can use SET 
PREFIX SYNONYM to assign a synonym that is up to five characters 
long. 

o The synonym can be a special character that is not permitted as part of 
a CMS filename. For example, the filename for the XEDIT prefix macro 
> is PRFSHIFT. 

o A macro can perform different functions, depending on how it is 
" } entered. Different synonyms can signify different functions to the 

"" macro. For example, the XEDIT prefix macro PRFSHIFT shifts the 

' I screen right if > is entered and left if < is entered. The synonyms 

assigned to this macro are: 

SET PREFIX SYNONYM > PRFSHIFT 
1 SET PREFIX SYNONYM < PRFSHIFT 

SET PREFIX SYNONYM > > PRFSHIFT 
" ] SET PREFIX SYNONYM < < PRFSHIFT 

"1 o Prefix macros can also use the names of prefix subcommands such as F 

(following) or P (preceding). To use a prefix subcommand in a prefix 

~J\ macro, you should either define a synonym (see SET PREFIX in the 

VM/SP System Product Editor Command and Macro Reference) or 

" ] override the prefix subcommand by using SET MACRO ON. 

] To determine what prefix macro synonyms are in effect, use the QUERY 

PREFIX SYNONYM subcommand, which is described in detail in the 
1] VM/SP System Product Editor Command and Macro Reference. 



J 



Using the "Pending List" 



~ You have seen that the source and argument strings are two sources of 

" 1 information upon which a prefix macro can base decisions. Another is the 

~ "pending list." 

~'i 

The "pending list" is a list of prefix subcommands and macros that have not 
~ l yet been executed. Every time the editor reads the screen, the pending list 

~ is updated (automatically) with any new prefix subcommands and macros 

" ] that have been entered, each of which causes an entry to be added to the 

list. Each entry is associated with a specific line in the file. 

~~ The pending list is executed when it is changed. If a prefix macro returns a 

~ 1 non-zero return code, execution of the pending list stops and all entries not 

executed remain pending, until the user presses the ENTER (or PF/or PA) 
J " key. 
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An entry is deleted from the pending list when it is executed or overtyped 
on the user's screen with a new prefix subcommand, prefix macro, or 
blanks. For example, when the L prefix macro is invoked, it is removed 
from the pending list. 

A prefix macro can control its execution and display or remove the pending 
notice from the status area of the screen by examining information in the 
pending list (EXTRACT/QUERY PENDING) and by adding or deleting 
entries in it (SET PENDING). Refer to the VMjSP System Product Editor 
Command and Macro Reference for detailed information on these 
subcommands. 

The pending notice is displayed in the status area as follows: 

'value' pending... 

where "value" is the name of the prefix subcommand or macro that was 
entered in the prefix area, as derived from the source string (see line 34). 
(If multiple prefix subcommands or macros are pending, the first one, 
starting from the top of file, is displayed in the pending notice.) 

In our example, suppose that the user entered the block form (LL), which is 
determined by line 26. First, the macro needs to know if another LL has 
been entered, that is, if the pending list contains a matching block entry. 

To determine this, the macro examines the pending list by issuing the 
EXTRACT subcommand shown in line 29. This subcommand searches the 
pending list for a matching block entry, which must be located in the file 
within the range specified by the targets, that is, between the top of file (:0) 
and the prefix line (:pline), inclusive. If no matching entry is found, the 
screen is placed in a pending status (line 34). 



If a second LL was entered, the pending status of the screen will not be 



ooori 



r\an* 



fVw 



:o is automatically invoked again as the pending 



list 



is executed. This time, the EXTRACT subcommand (line 29) finds the 
matching block entry, the pending notice is removed (line 31) and the 
LOWERCAS subcommand is executed for the block of lines (line 32). 



Examining the Argument String 



The argument string is as follows: 

PREFIX SET | SHADOW | CLEAR pline [opl [op2 [op3 ] ] ] 

Where: 

PREFIX 

indicates that this is a prefix call. 



158 VM/SP System Product Editor User's Guide 




3 

3 
3 



3 
3 
3 

:i 

3 
3 
3 
3 
3) 
3 
3 
3 
3 
3 
3 
3 
3 



SET 

indicates that the prefix macro was entered on some line in the file 
displayed. 

SHADOW 

indicates that a prefix macro was entered on a shadow line (see SET 
SHADOW in the VM/SP System Product Editor Command and Macro 
Reference). 

CLEAR 

indicates that a new prefix subcommand or macro or new blank area 
replaces a previously pending prefix subcommand or macro on the 
same line, or the RESET subcommand was entered. In this case, this 
macro is invoked with "PREFIX CLEAR pline". 



pline 

is the line number on which the prefix macro was entered. 

opl op2 op3 

are the optional operands of the macro, entered either to its left or 
right (for example, 5M or M5). (Operands are recognized according to 
the rules explained in "Section 4: Prefix Subcommands and Macros" in 
the VMjSP System Product Editor Command and Macro Reference.) 

Let's see how this macro uses the argument string for validity checking. 



00008 


arg pref func pline op extra 


00009 


If pref -i= 'PREFIX' then call errorl, 


00010 


'This macro must be invoked from the PREFIX area. 1 


00011 


If func = 'CLEAR' then exit 


00012 


If func = 'SHADOW then call errorl, 


00013 


'Invalid on shadow line.' 


00014 


If func -i= 'SET' then call errorl, 


00015 


'This macro must be invoked from the PREFIX area.' 


00016 


If extra -i= ' ' then call error, 


00017 


'Extraneous parameter:' extra 


00042 


/* error routines */ 


00043 


error: 'COMMAND : 'pline 'SET PENDING ERROR' name | | op 


00044 


errorl: parse arg t 


00045 


'COMMAND EMSG' t 


00046 


Exit 



Lines 9 through 17 verify that the macro is a prefix call and was entered on 
a valid prefix line, that is, not on a shadow line. Lines 42 through 45 are 
the associated error routines. 

Line 43 is a form of the SET PENDING subcommand used to notify the user 
the macro was entered incorrectly. In this case, if an extra operand was 
entered (determined in line 16), the incorrect macro is displayed highlighted 
in the prefix area, prefixed by a question mark. For example, if the user 
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entered L3 4, the prefix area displays ?L3 and the user gets the message 
'Extraneous parameter: 4'. 

SET PENDING ERROR does not cause a pending notice to be displayed. 
When the user presses the ENTER key again, the prefix area is reset. This 
prevents subsequent attempts to execute an incorrectly-entered macro. 



Positioning the Cursor 



The cursor is positioned in the line in which the prefix macro was entered 
by using the following subcommand: 



00039 'COMMAND CURSOR FILE' pline 'PRIORITY 30' 



By using the CURSOR subcommand, user-written prefix macros can specify 
a priority that is associated with cursor positioning. The cursor is 
positioned at the location specified that has the highest priority when all 
pending prefix subcommands and any macros are executed. 

For more information on the CURSOR subcommand and various priorities 
associated with prefix subcommands and macros, see the VM/SP System 
Product Editor Command and Macro Reference, the CURSOR subcommand 
and "Section 4: Prefix Subcommands and Macros." 

The rest of this chapter presents additional information which may be 
useful in writing prefix macros or tells you where the information can be 
found. 



How the Prefix Area Is Decoded 



See the VM/SP System Product Editor Command and Macro Reference, 
"Section 4: Prefix Subcommands and Macros" for a description of how the 
editor interprets what is entered in the prefix area. 



Using the XEDIT Subcommand 



A prefix macro can issue the XEDIT subcommand to edit a different file in 
the ring. However, when the macro finishes executing, control 
automatically returns to the file from which it was invoked. 
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Additional Examples 



For additional examples of prefix macros, you can examine the 
IBM-supplied prefix macros, which are as follows: 

Macro synonym(s) File Identifier 



X, XX 

s 

< . > . > > . < < 



PREFIXX XEDIT 
PRFSHOW XEDIT 
PRFSHIFT XEDIT 
SI XEDIT 



:j 

3 
J 
J 
2 
3 



3 
3 
3 
3 
J 
'J 
J 
J 
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The L Prefix Macro 



00001 


/* Use this macro to translate a line or lines in a file 


V 


00002 


/* to lowercase. 


V 


00003 


/* You may specify nL, Ln, L-n or L to lowercase a line. 


*/ 


00004 


/* If you add the following prefix synonym to your 


*/ 


00005 


/* profile, you may also use LL for specifying blocks: 


V 


00006 


/* SET PREFIX SYNONYM LL L 


V 


00007 


parse source name . 




00008 


arg pref func pline op extra 




00009 


If pref -i= "PREFIX 1 then call error 1, 




00010 


'This macro must be invoked from the PREFIX area. 1 




00011 


If func = 'CLEAR 1 then exit 




00012 


If func = 'SHADOW then call error 1, 




00013 


'Invalid on shadow line.' 




00014 


If func -i= 'SET 1 then call errorl, 




00015 


'This macro must be invoked from the PREFIX area.' 




00016 


If extra -i= '' then call error, 




00017 


'Extraneous parameter:' extra 




00018 


select 




00019 


when length ( name )=1 then do 




00020 


If op = ' ' then op = 1 




00021 


If datatype (op, 'W ) then, 




00022 


'COMMAND : 'pline ' LOWERCAS ' op 




00023 


else call error "Invalid operand :" op 




00024 


end 




00025 






00026 


when length (name) =2 then do 




00027 


If op -i= ' ' then call error, 




00028 


'Invalid operand :' op 




00029 


•COMMAND EXTRACT /PENDING BLOCK' name ':0 -.'pline '/' 


00030 


if pending. 0-i=0 then do 




00031 


'COMMAND :' pending. 1 'SET PENDING OFF' 




00032 


'COMMAND :' pending. 1 'LOWERCAS : 'pline+1 




00033 


end 




00034 


else 'COMMAND : 'pline 'COMMAND SET PENDING BLOCK 


name 


00035 


End 




00036 






00037 


Otherwise call error "Invalid macro synonym." 




00038 


End 




00039 


'COMMAND CURSOR FILE' pline 'PRIORITY 30' 




00040 


Exit 




00041 






00042 


/* error routines */ 




00043 


error: 'COMMAND : "pline 'SET PENDING ERROR' name | | op 




00044 


errorl: parse arg t 




00045 


'COMMAND EMSG' t 




00046 


Exit 





Figure 40. A Sample Prefix Macro. 
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Appendix A. A Summary of XEDIT Subcommands and Macros 



J 



:] 



3 



1) 



Subcommand 


Purpose 


Add 


Add n lines after current line. 


ALL 


Select a collection of lines for display/editing. 


ALter 


Change a single character to another (character or 
hex). 


BAckward 


Scroll backward n frames. 


Bottom 


Go to last line of file. 


CANCEL 


Terminate all files. 


CAppend 


Add text to end of current line. 


CDelete 


Delete characters, starting at column pointer. 


CFirst 


Move column pointer to beginning of line (zone). 


Change 


Change one string to another. 


CInsert 


Insert text in the current line. 


CLAst 


Move the column pointer to the end of the line 
(zone). 


CLocate 


Locate a string; move the column pointer and the 
line pointer. 


CMS 


Pass a command to CMS, or enter CMS subset 
mode. 


CMSG 


Display message in command line of user's screen. 


COMMAND 


Execute a subcommand without checking for 
synonym or macro. 


COMPress 


Prepare line(s) for realignment by replacing blanks 
with tab characters. 


COpy 


Copy line(s) at specified location. 


COUnt 


Display the number of times a string appears. 


COVerlay 


Replace characters, starting at column pointer. 


CP 


Pass command to VM/SP control program. 


CReplace 


Replace characters, starting at the column pointer. 


CURsor 


Move the cursor to specified position on the 
screen, and optionally assign a priority for this 
position. 


DELete 


Delete line(s). 


Down 


Move line pointer n lines toward end of file (same 
as NEXT). 


DUPlicat 


Duplicate line(s). 


EMSG 


Display a message and sound the alarm. 


EXPand 


Reposition data according to new tab settings. 
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Subcommand 


Purpose 


EXTract 


Return information about internal XEDIT 
variables and file data. 


FILE 


Write file on disk. 


Find 


Search for line that starts with specified text. 


FINDUp 


Search for a line that starts with specified text; 
searches in a backward direction. 


FOrward 


Scroll forward n frames. 


GET 


Insert lines from another file. 


Help 


Request online display of XEDIT subcommands 
and macros; invoke the CMS HELP facility. 


HEXType 


Display line(s) in hexadecimal and EBCDIC. 


Input 


Insert a single line, or enter input mode. 


Join 


Join lines. 


LEft 


View data to the left of column one. 


LOAD 


Read file into storage; use in profile macro only. 


Locate 


Move line pointer to specified target. 


LOWercas 


Change uppercase letters to lowercase. 


LPrefix 


Simulate writing in the prefix area of the current 
line and pressing the ENTER key. 


MACRO 


Execute macro without checking for subcommand 
or synonym. 


MErge 


Combine two sets of lines. 


MODify 


Display a SET subcommand current values in the 
command line, so it can be overtyped and 
reentered. 


MOve 


Move line(s) to another place in the file. 


MSG 


Display message in message line. 


Next 


Move line pointer n lines toward end of file (same 
as DOWN). 


J.-* A' 111U. 


Search for first line that does not match specified 
text. 


NFINDUp 


Search backward for first line that does not match 
specified text. 


Overlay 


Replace characters in current line. 


PARSE 


Scan a line of a macro to check the format of its 
operands. 


POWerinp 


Enter an input mode for continuous typing. 


PREServe 


Save settings of variables until RESTORE. 


PURge 


Remove macro from virtual storage. 


PUT 


Insert lines into another file (new or existing), or 
into a buffer (to be retrieved by GET from another 
file). 


PUTD 


Same as PUT, but delete original lines. 
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Subcommand 


Purpose 


Query 


Display the current value of editing options. 


QUIT 


End an editing session without saving changes. 


READ 


Place information from the terminal in the console 
stack. 


RECover 


Replace deleted lines. 


RENum 


Renumber VSBASIC or FREEFORT file. 


REPEat 


Advance line pointer and reexecute last 
subcommand. 


Replace 


Replace current line, or delete current line and 
enter input mode. 


RESet 


Remove prefix subcommands or macros when 
screen is in "pending" status. 


RESTore 


Restore settings of XEDIT variables to values they 
had when PRESERVE was issued. 


RGTLEFT 


Shift display to the right; reissue to shift back to 
original display. 


Right 


View data to the right of the last (right-most) 
column. 


SAVE 


Write file on disk and remain in edit mode. 


SCHANGE 


Make a selective change, using PF keys. 


SET ALT 


Change the number of alterations that have been 
made to the file since the last AUTOSAVE and/or 
since the last SAVE. 


SET APL 


Inform the editor if APL keys are used. 


SET ARBchar 


Define an arbitrary character, which allows you to 
specify only the beginning and the end of a 
character string that is the object of a target 
search. 


SET AUtosave 


Automatically issue a SAVE subcommand at 
specified intervals. 


SET BRKkey 


Specifies whether or not CP should break in when 
the "BRKKEY " (defined by CP TERMINAL 
BRKKEY) is pressed. 


SET CASE 


Uppercase or lowercase control; specify if case is 
significant in target searches. 


SET CMDline 


Move the position of the command line. 


SET COLOR 


Associate specific colors and attributes with 
various fields on the XEDIT screen. 


SET COLPtr 


Specify if column pointer is displayed (typewriter 
terminals only). 


SET CTLchar 


Define a control character(s), which associate 
parts of a reserved line with highlighting, 
protection, visibility, various colors, extended 
highlighting, and Programmed Symbol Sets. 


SET CURLine 


Define the position of the current line on the 
screen. 
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Subcommand 


Purpose 


SET DISPlay 


Indicate which selection levels of lines will be 
displayed on the screen. 


SET ENTer 


Define a meaning for the ENTER key. 


SET ESCape 


Define a character that allows you to enter a 
subcommand while in input mode (typewriter 
terminals only). 


SET 
ETARBCH 


Define an arbitrary character within a file 
containing Double-Byte Character Set (DBCS) 
characters. Allows you to specify only the 
beginning and end of a character string that is the 
object of a target search. 


SET ETMODE 


Inform the editor that there are Double-Byte 
Character Set strings in the file. 


SET FILler 


Define a character that is used when a line is 
expanded. 


SET FMode 


Change the filemode of the current file. 


SET FName 


Change the filename of the current file. 


SET FType 


Change the filetype of the current file. 


SET FULLread 


Determine whether or not the editor recognizes 
null characters in the middle of screen lines. 


SET HEX 


Allows string targets to be specified in 
hexadecimal. 


SET IMage 


Control how tabs and backspaces are handled. 


SET IMPcmscp 


Control whether subcommands not recognized by 
the editor are transmitted to CMS and CP. 


SET 

LASTLorc 


Define the contents of the last locate or change 
buffer. 


SET LINENd 


Define a line end character. 


SET LRecl 


Define a new logical record length. 


SET MACRO 


Control the order in which the editor searches for 
subcommands and macros. 


oirnn hit a ott- 
uii j. in.n.ox&. 


Define a new mask, which is the contents of added 
lines and the input zone. 


SET 
MSGLINE 


Define position of message line and the number of 
lines a message may expand to. 


SFT 

MSGMode 


Control the message displa}'. 


SET NONDisp 


Define a character that is used in place of 
non-displayable characters. 


SET NULls 


Specify whether trailing blanks are replaced with 
nulls to allow character insertion. 


SET NUMber 


Specify whether file line numbers are displayed in 
the prefix area. 


SET PAn 


Define a meaning for a PA key. 


SET PACK 


Specify if the file is to be written to disk in packed 
format. 
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Subcommand 


Purpose 


SET PENDing 


Add an entry to the pending list and display a 
pending notice in the status area, or notify the 
user that a prefix macro was entered incorrectly. 


SET PFn 


Define a meaning for a PF key. 


SET Point 


Define a symbolic name for the current line. 


SET PREfix 


Control the display of the prefix area; define a 
synonym for a prefix subcommand. 


SET RANge 


Define a new "top" and "bottom" for the file. 


SET RECFm 


Define the record format. 


SET REMote 


Control the way data transmission is handled. 


SET 
RESERved 


Reserve a line, which cannot be used by the editor. 


SET SCALe 


Control the display of the scale line. 


SET SCOPE 


Specify whether the editor operates on the entire 
file or on only those lines displayed. 


SET SCReen 


Divide the screen into logical screens, for multiple 
views of the same or of different files. 


SET SELect 


Assign a selection level to a line or group of lines 
in a file. 


SET SERial 


Control file serialization. 


SET SHADow 


Specify whether the file is to be displayed with or 
without shadow lines indicating where lines have 
been excluded from the display. 


SET SIDcode 


Specify a character string that is to be inserted 
into every line of an update file. 


SET SPAN 


Allows a string target to span a number of lines. 


SET SPILL 


Control whether or not truncation will occur for 
certain subcommands. 


SET STAY 


Specify for certain subcommands whether the line 
pointer moves when searching for a string. 


SET STReam 


Specify whether the editor searches only the 
current line or the whole file for a column-target. 


SET SYNonym 


Specify whether the editor looks for synonyms; 
assign a synonym. 


SET TABLine 


Control the display of the tab line. 


SET TABS 


Define the logical tab stops. 


SET 
TERMinal 


Specify whether a terminal is used in line mode or 
full-screen mode. 


SET TEXT 


Inform the editor if TEXT keys are used. 


SET TOFEOF 


Control the display of TOF/EOF lines. 


SET 
TRANSLat 


Control user-defined uppercase translation. 


SET TRunc 


Define the truncation column. 
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Subcommand 


Purpose 


SET 

VARblank 


Specify whether the number of blanks between two 
words is significant in a target search. 


SET Verify 


Control whether lines changed by subcommands 
are displayed; define the columns displayed and 
whether displayed in EBCDIC or hexadecimal or 
both. 


SET WRap 


Control whether the editor wraps around the file if 
EOF (or TOF for backwards searches) is reached 
during a search. 


SET Zone 


Define new limits within each line for target 
searches. 


SET = 


Insert string into the equal buffer. 


SHift 


Move data right or left (data loss possible). 


SI 


Continuously add lines and position cursor for 
indented text. 


SORT 


Sort all or part of a file, in ascending or 
descending order. 


SOS 


Specify functions for screen operation simulation. 


SPlit 


Split a line into two or more lines. 


SPLTJOIN 


Split a line or join two lines at the cursor. 


STAck 


Place line(s) from the file into the console stack. 


STATus 


Display SET subcommand current settings; create 
a macro that contains these settings. 


TOP 


Move line pointer to null TOP OF FILE line. 


TRAnsfer 


Place editing variable(s) in the console stack, for 
use by a macro. 


Type 


Display lines. 


Up 


Move line pointer toward top of file. 


UPPercas 


Translate all lowercase characters to uppercase. 


Xedit 


Edit multiple files. 


& 


Use before a subcommand for repeated execution. 


= 


Reexecute the last subcommand or macro. 


? 


Display the last subcommand executed. 



Prefix 


Subcommands 


A 


Add line(s). 


C 


Copy line(s). 


D 


Delete line(s). 


E 


Extend a line. 


F 


Move or copy following this line. 


I 


Insert line(s). 


M 


Move line(s). 
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Prefix 


Subcommands 


P 


Move or copy preceding this line. 


SI 


Continuously add lines and position cursor for 
indented text. 


ii 


Duplicate line(s). 


/ 


Make this line the current line. 


SCALE 


Display the scale on this line. 


TABL 


Display the tab line on this line. 


.xxxx 


Assign symbolic name to this line. 


X 


Exclude line(s) from display. 


S 


Show excluded line(s). 


< 


Shift line(s) to the left. 


> 


Shift line(s) to the right. 
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.xxxx prefix subcommand 
< SHIFT LEFT MACRO 
$ (as arbitrary character) 
/ prefix subcommand 24 

practice exercise using 
> SHIFT RIGHT MACRO 
? subcommand 13 
# (as line end character) 

' ' pending 20 

""" pending 23 

'DD' pending 16 

= subcommand 14 

" prefix subcommand 22 

'C or 'CC pending 23 

'F* pending 23 

'M' or 'MM' pending 23 

'P' pending 23 



102 

48 

110 

53 

48 

8, 9 



A prefix subcommand 15 

practice exercise using 55 
absolute column number 34 
absolute line number, target as 

example of 99 
adding lines 

continuously 19 

of indented text 19 

using A prefix subcommand 

using SI 19 
adding subcommands 137 
adding text to end of line 115 

in typewriter mode 72 
alarm, sounding 141 
ALL 47 
Alt = 3 
ALTER 47 

in typewriter mode 88 
alteration count 3, 39 
altering a character 47 

in typewriter mode 88 
AND symbol, used in string target 
appending text to line 115 

in typewriter mode 72 
arbitrary character 110 
assigning a name to a line 102 
automatic save 3, 39 

in typewriter mode 81 



98 



15 



107 



backspace characters in typewriter mode 

BACKWARD 26 

backward search 30, 105 

blank characters in targets, significance of 

block of lines 

copying 23 

deleting 16 

duplicating 23 

moving 23 
BOTTOM 26 

in typewriter mode 67 

practice exercise using 53 
bypassing profile macro 150 



86, 88 



112 



E 



23 



72 



71 



69 



73 



C prefix subcommand 
CANCEL 119 
CAPPEND 115 

in typewriter mode 
case 

changing 48 

specifying 110 
CDELETE 115 

in typewriter mode 
CFIRST 36, 115 

in typewriter mode 
CHANGE 30 

in typewriter mode 

practice exercise using 56 

with absolute line number as target 
changing data 

globally 34 

in typewriter mode 

selectively 31 

in typewriter mode 

using CHANGE 30 
in typewriter mode 

using COVERLAY 115 

using CREPLACE 115 
changing data position 48 
changing definition of a character 

in typewriter mode 88 
changing tab settings 37 

in typewriter mode 87 
changing the screen layout 127 
character delete, using CDELETE 
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98 



73 



74 



73 



47 



115 



cnaracier aejete, using ^ushLjihL Cj ii 
character insert, using CINSERT 34, 115 
character overlay, using COVERLAY 



character overlay, using COVERLAY 115 
character replace, using CREPLACE 115 
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CINSERT 34, 115 

in typewriter mode 69 
CLAST 115 

CLEAR key, to remove prefix subcommands 24 
CLOCATE 29, 114 

in typewriter mode 68 
CMS commands, issuing from a macro 143 
CMS subcommand 143 
CMSG 142 
Col = 3 
color, defining 

with SET COLOR 128 

with SET CTLCHAR 143 

with SET RESERVED 142 
column pointer 

defined 5 

displayed in the scale 5 

displayed on typewriter terminal 64 

indicator in file identification line 3 

moving 29, 114 

in typewriter mode 68 
to beginning of line 115 
to end of line 115 

resetting 36, 115 

in typewriter mode 69 

subcommands based on position of 68, 115 
column-target 114 
columns, specifying for viewing 48 
combining files 40 

in typewriter mode 82 
combining SET options 112 
command input area 3 
command line 

changing location 127 
example of 131 

defining display features 128 

displaying message in 142 

location on screen 3 
commands, issuing from a macro 143 
complex string expression as target 110 

example of 113 
COMPRESS 48 
concantenating files 40 

in typewriter mode 82 
console stack 139 
COPY in typewriter mode 79 
copying lines 

in typewriter mode 79 

using C prefix subcommand 23 
COUNT 98 

example of 99 
COVERLAY 115 

CP commands, issuing from a macro 143 
CP subcommand 143 
creating a file 1 

in typewriter mode 61 
creating a macro file 138 
CREPLACE 115 
current column 5 

in typewriter mode 64 



current line 

appending words to 115 

in typewriter mode 72 
as starting place for subcommands 4 
changing 

using / 24 

using a target 92 

using dLpCATE 29 

using DOWN 27 

using UP 27 
changing location on screen 128 

example of 132 
defining display features 128 
displaying in typewriter mode 65 
indicator in file identification line 3 
location on screen 4 
replacing, in typewriter mode 77 
using target as displacement from 100 
CURSOR 143 

cursor placement in multiple screens 124 
cursor, moving 

to command line 3 

to specified location 143 



D 



D prefix subcommand 16 

practice exercise using 55 
data, changing 

globally 34 

in typewriter mode 73 

selectively 31 

in typewriter mode 74 

using CHANGE 30 

in typewriter mode 73 

Using COVERLAY 115 

using CREPLACE 115 
data, entering 

on display terminal 5 

on typewriter terminal 62 
data, locating 

using a target 105 

using CLOCATE 2% 

in typewriter mode 68 
defining screen size 120 
DELETE in typewriter mode 76 
deleting characters 115 

in typewriter mode 71 
deleting lines 

block of lines 16 

recovering 18 

in typewriter mode 77 

using D prefix subcommand 16 

using DELETE in typewriter mode 76 
delimiters, using 29 

in typewriter mode 68 
destination line 
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F prefix subcommand 23 

for copied lines 23 

for moved lines 23 

P prefix subcommand 23 
display features 128 
display screen layout 2 
displaying data from a macro 141 
displaying help menus 47 
displaying line numbers 44 
displaying lines on typewriter terminal 63 
displaying messages on editor screen 141 
displaying more than one file 121 
displaying tab settings 37 

in typewriter mode 87 
dividing screen 120 
DOWN 27 

example of 28 

in typewriter mode 66 

practice exercise using 53 
duplicating lines 22 



E 



edit environment 1 

in typewriter mode 61 
edit mode 5 

in typewriter mode 62 
editing multiple files 117 

illustration of 119 
editing one file 1 

in typewriter mode 61 
editing options 

See editing variables 
editing variables 

preserving 143 

restoring 143 

transferring 140 
editing, defined 1 

in typewriter mode 
editor, invoking 1 

in typewriter mode 
EMSG 141 
ending editing session 

in typewriter mode 
entering data 5 

using INPUT 5 

in typewriter mode 

using POWERINP 8 
entering prefix subcommands 4, 15 
entering subcommands 3 
entering XEDIT subcommands 5 

on typewriter terminal 61 
EOF 65 
error message display 3 

in typewriter mode 62 
EXEC 2 file used as XEDIT macro 



61 

61 

38, 
80 



119 



62 



executing a subcommand 3 

exercises, practice 51 

exiting the editor 38, 119 
in typewriter mode 80 

EXPAND 48 

extended highlighting, defining 
with SET COLOR 128 
with SET CTLCHAR 143 
with SET RESERVED 142 

EXTRACT 139 



F prefix subcommand 23 

FILE 38 

in typewriter mode 80 
practice exercise using 51 

file area on screen 4 

file identification line 2 

file, inserting 40 

in typewriter mode 82 

filemode 3 

filemode of XEDIT macro 138 

filename of XEDIT macro 138 

filename of XEDIT prefix macro 

filetype of XEDIT macro 138 

finding data 

using a target 105 
using CLOCATE 29 

in typewriter mode 68 

FORWARD 26 

forward search 105 

full-screen mode 1 



138 



G 



GET 46, 44 !;; : 

in typewriter mode 82 
practice exercise using 

global change 34 

in typewriter mode 73 



57 



H 



137 



HELP 47 

help display 47 

highlighting, defining 

with SET COLOR 128 
with SET CTLCHAR 143 
with SET RESERVED 142 

horizontal screens, multiple 120 
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62 



53 



information message display 3 

in typewriter mode 62 
initial setting of PF keys 11 
INPUT 

practice exercise using 51 

to enter input mode 5 

on typewriter terminal 62 

to enter line in typewriter mode 
INPUT line 75 
input mode 5 

on typewriter terminal 
input zone 5 

changing size 128 
insert mode key 9, 14 

practice exercise using 
inserting a blank line 75 
inserting a file 

in typewriter mode 82, 83 

part of 43 

example of 46 

whole file 40 
example of 42 
inserting characters 

in input mode 14 

in power typing mode 9, 14 

using CINSERT 34, 115 
in typewriter mode 69 

using PA2 key 14 

using SET NULLS 14 

using the insert mode key 14 
inserting data 

from another file 40 

in typewriter mode 82 

using CINSERT 34, 115 
in typewriter mode 69 
inserting lines using INPUT 6 

in typewriter mode 63, 67, 75 
inserting words 

using CINSERT 34, 115 
in typewriter mode 69 
invoking the editor 1 

in typewriter mode 61 



75 







joining files 40 

in typewriter mode 82 
joining lines 11 



labelling a line 102 
LEFT 48 

line end character 8 
line name, target as 102 

example of 104 
line number, displaying 44 
line pointer 4 

in typewriter mode 64 

moved by target 92 
Line = 3 
LOAD 150 
LOCATE 95 
locating data 

using a target 105 

using CLOCATE 29 

in typewriter mode 68 
logical record length 62 
logical screens, multiple 120 
LOWERCAS 48 
LPREFIX in typewriter mode 80 



M 



M prefix subcommand 23 

practice exercise using 55 
MACRO 144 
macro language 137 
macro, XEDIT 

argument string 158 

avoiding name conflicts 144 

creating 138, 153 

cursor position 160 

definition of 137 

examples of 143, 145, 151, 153, 162 

executing 137 

file identifier 138 

handling blocks 156 

information passed 139, 153, 155 

prefix 153 

profile 150 

search order, specifying 144 

source string 154 

subcommands used in 138 

XEDIT prefix macro 160 
MERGE 48 
message 

controlling display of 142 

displaying in command line 142 

displaying on editor screen 141 

error 3 

in typewriter mode 62 

information 3 

issued from a macro 141 
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128 



warning, example 39 
message line 

changing location 128 
defining display features 
location on screen 3 
MODIFY TABS 37 
modifying tab settings 37 
MOVE in typewriter mode 78 
moving cursor to command line 3 
moving cursor to specified location 
moving display right or left 48 
moving lines 78 

in typewriter mode 78 
using M prefix subcommand 23 
moving through a file 

using BACKWARD 26 
using BOTTOM 26 

in typewriter mode 
using DOWN 27 

in typewriter mode 
using FORWARD 26 
using PF keys 13 
using TOP 26 

in typewriter mode 
using UP 27 

in typewriter mode 
MSG 141 
multiple files 

displaying 117 
editing 118 

illustration of 119 
ending editing sessions for 
on one screen 123 
example of 125 
multiple logical screens 
defining 120 
example of 122 
multiple views 

of different files 123 

example of 125 
of same file 121 
example of 122 
making changes in 
order of processing in 



143 



67 



66 



67 



66 



119 



121 
123 



N 



names, avoiding conflicts of macro 

naming a line 48, 102 

NOT symbol, used in string target 

NULLKEY 14 

number of files being edited 3 



144 



106 



o 



operand, target as 95 

OR symbol, used in string target 106 

order of processing with multiple screens 



123 







55 



53 



128 



P prefix subcommand 23 

practice exercise using 
PA2 key 14 

practice exercise using 
pending list 123, 157 
pending notice 

' ' pending 20 

""" pending 23 

'DD' pending 16 

'C or 'CC pending 23 

'F' pending 23 

'M' or 'MM' pending 23 

'P' pending 23 

cancelling 24 

defining display features 

location on screen 3 
PF keys 

changing settings of 11 

displaying settings of 11 

initial settings of 11, 50 

using 11 
power typing mode 

example of 9 

inserting characters in 9 

typing data in 5, 8 

using line end character in 
POWERINP 8 

practice exercise using 53 
practice exercise 51 
prefix area 

changing location or display 
example of 130 

defining display features 128 

location on screen 4 

simulate in typewriter mode 80 
prefix macro 

assigning a synonym 156 

examples of 153 

writing 153 
prefix subcommands 

.xxxx 102 



17 



127 



/ 


24 




A 


15 






example 


;of 


C 


23 




canceling 


24 


D 


16 






example of 



17 
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defined 15 

F 23 

example of 25 

list of 15,49 

M 23 

example of 25 

P 23 

practice exercise using 55 

SI 19 

example of 19 

where to enter 4 
PRESERVE 143 
preserving editing variables 143 
processing with multiple screens, order of 
profile macro, XEDIT 

definition of 150 

example of 151 
programmed symbol sets, defining 

with SET COLOR 128 

with SET CTLCHAR 143 

with SET RESERVED 142 
PUT 43 

in typewriter mode 83 

practice exercise using 57 



123 



Q 



81 



QQUIT 39 

in typewriter mode 
QUERY LRECL 63 
QUERY PF 11 
QUERY POINT 103 
QUERY RING 118 
QUERY TABS 37 

in typewriter mode 

practice exercise using 
QUIT 39 

in typewriter mode 80 



87 



51 



R 



range of operation of subcommands, defining 95 
READ 139 
record format 3 
record length 3 

in typewriter mode 62 
RECOVER 18 

example of 18 

in typewriter mode 77 

practice exercise using 55 
recovering deleted lines 18 

in typewriter mode 77 
redefining a character 47 

in typewriter mode 88 



redisplaying a subcommand 13 
reexecuting a subcommand 14 
referring to a line 102 
relative displacement, target as 100 

example of 101 
repeating the display of a subcommand 13 
repeating the execution of a subcommand 14 
REPLACE in typewriter mode 77 
replacing a line in typewriter mode 77 
replacing data 

globally 34 

in typewriter mode 

selectively 31 

in typewriter mode 

using CHANGE 30 
in typewriter mode 

using COVERLAY 115 

using CREPLACE 115 
reposition data 48 

reserving a screen line for use by a macro 
RESET 24 
RESET key 14 

to end insert mode 9 
RESTORE 143 

restoring editing variables 143 
REXX file used as XEDIT macro 137 
RIGHT 48 
ring of files 117 

editing 118 

illustration of 118 



73 



74 



73 



S 



save, automatic 39 

in typewriter mode 81 
saving editing variables 143 
scale 

changing location or display 128 

defining display features 128 

example of 133 

location on screen 4 
screen layout 2 

changing 127 
screen size, defining 120 
scrolling the screen 

using BACKWARD 26 

using FORWARD 26 

using PF keys 13 
search direction, specifying 105 
search order of macros and subcommands, 

specifying 144 
searching for data 

using a target 105 

using CLOCATE 29 

in typewriter mode 68 
selective change 31 

example of 33 
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in typewriter mode 74 
SET ARBCHAR 48, 110 
SET AUTOSAVE 39 

in typewriter mode 81 

practice exercise using 51 
SET CASE 48, 111 
SET CMDLINE 127 

example of 131 
SET COLOR 128 
SET CTLCHAR 143 
SET CURLINE 128 

example of 132 
SET HEX 108 

SET IMAGE in typewriter mode 86, 88 
SET MACRO 144 
SET MSGLINE 128 

example of 135 
SET MSGMODE 142 
SET NULLS 14 
SET NUMBER 44, 98, 129 
SET options, combining 112 
SET PFn 11 
SET POINT 48, 102 
SET PREFIX 127 

example of 130 
SET RESERVED 142 
SET SCALE 128 

example of 133 
SET SCREEN 48, 120 

example of 122, 125 
SET SPAN 110, 111 
SET SYNONYM 144 
SET TABLINE 128 
SET TABS 37 

example of 134 

in typewriter mode 87 

practice exercise using 51 
SET VARBLANK 110, 112 
SET VERIFY 48 
setting tabs 37 

in typewriter mode 87 
shifting display right or left 48 
SI prefix subcommand 19 
simple string expression as target 

example of 109 

format of 107 
size of file 3 
size of logical screen 120 
Size= 3 
SORT 48 
sorting 48 
spanning lines 111 
special characters in typewriter mode 

altering 88 

using 86 
splitting lines 11 
splitting screen 120 
status 

' ' pending 20 

""" pending 23 



23 



23 



128 
139 



'DD' pending 16 

■C or 'CC pending 

'F pending 23 

'M' or 'MM' pending 

T' pending 23 
status area 

defining display features 

during macro processing 

location on screen 3 
status of editing session 3 
string expression 

complex 

target as 110 

simple 

target as 105 
string target 105 
string, locating 

using a target 105 

using CLOCATE 29 
in typewriter mode 
structured input 19 
subcommands, XEDIT 

defining range of operation 95 

entering on display terminal 3 

entering on typewriter terminal 

used in macros, list of 138 

with target operands 91 

writing your own 137 
summary 

of initial PF key settings 50 

of prefix subcommands 168 

of subset for full-screen 49 

of subset for typewriter terminals 89 

of XEDIT subcommands and macros 163 
symbolic name, assigning 48 
synonym 

assigning 156 

not checking for 144 
System Product Interpreter 137 



68 



61 







tab characters in typewriter mode 86 
tab key 

in typewriter mode 86 

using PF key as 37 
example of 38 
tab line 

defining display features 128 

displaying 128 

example of 134 
tab settings 37 

in typewriter mode 86 
tabbing 

using PF key 37 
tabs 

displaying 37 
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example of 38 

in typewriter mode 87 

setting 37 

in typewriter mode 87 
tailoring the screen 127 
target 

as absolute line number 98 

example of 99 
as complex string expression 110 

example of 113 
as line name 102 

example of 104 
as operand of LOCATE 95 
as relative displacement 100 

example of 101 
as simple string expression 105 
example of 109 
format of 107 
as subcommand operand 95 

example of 97 
definition of 91 
entered alone 92 
entered before subcommand 95 
how to express 91 
types of 98 
used in PUT 83 
used in subcommands 91 
used to change current line 92 
used to move line pointer 92 
example of 94 
TOF 65 
TOP 26 

in typewriter mode 67 
practice exercise using 53 
translating characters 48 
Trunc = 3 
truncation column 3 
TYPE 65 
typewriter mode 61 
tvninc lines to terminal 65 



u 



UP 27 

in typewriter mode 66 
practice exercise using 53 

UPPERCAS 48 
example of 97 



V 



variables, XEDIT 

See editing variables 
vertical screens, multiple 

example of 125 



120 



w 



writing file on disk 38 

in typewriter mode 80 
writing macros 137 
writing your own subcommands 



137 



X 



XEDIT command 1 

in typewriter mode 61 

practice exercise using 51 

used to bypass profile macro 150 

used to specify profile macroname 150 
XEDIT macro 

See macro, XEDIT 
XEDIT subcommand 117, 121 

issued from a logical screen 121 
XEDIT subcommands 5 
XEDIT variables 

See editing variables 
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